Python程序里的注釋是很重要的。它們可以用自然語言告訴你某段代碼的功能是什么。在你想要臨時移除一段代碼時，你還可以用注解的方式將這段代碼臨時禁用。接下來的練習將讓你學會注釋 :
# A comment, this is so you can read your program later.
# Anything after the # is ignored by python.
print "I could have code like this." # and the comment after is ignored
# You can also use a comment to "disable" or comment out a piece of code:
# print "This won't run."
print "This will run."
從現在開始，我將用這樣的方式來寫代碼。我一直在強調“完全相同”，不過你也不必按照字面意思理解。你的程序在屏幕上的顯示可能會有些不同，不過重要的是你在文本編輯器中輸入的文本的正確性。實際上，我可以用任何編輯器寫出這段程序，而且內容是完全一樣的。
當然那是英文的，我們可以用中文寫，請恕我裝了裝X
結果
$ python ex2.py
I could have code like this.
This will run.
$
再次說明，我不會再貼各種屏幕截圖了。你應該明白上面的內容是輸出內容的字面翻譯，而 $python ... 和最后的 $ 之間才是你應該關心的內容。
讀者可以看看下面的習題
1. 弄清楚” #” 符號的作用。而且記住它的名字。 ( 中文為井號，英文為 octothorpe 或者 poundcharacter) 。
2. 打開你的 ex2.py 文件，從后往前逐行檢查。從最后一行開始，倒着逐個單詞單詞檢查回去。
3. 有沒有發現什么錯誤呢？有的話就改正過來 .
4. 朗讀你寫的習題，把每個字符都讀出來。有沒有發現更多的錯誤呢？有的話也一樣改正過來。
常見問題回答
你確定 # 符號的名稱是 pound character ？
我叫它 octothorpe ，這個名字沒有哪個國家在用，不過所有的人都能看懂它的意思。每個國家都覺得他們的叫法最正確最閃亮。對我來說這是自大狂的想法，而且你也沒必要去關心這種細枝末節，學習編程才是更重要的事情。
如果 # 是注解的意思，那么為什么 # -*- coding: utf-8 -*- 能起作用呢？
Python 其實還是沒把這行當做代碼處理，這種用法只是讓字符格式被識別的一個取巧的方案，或者說是一個沒辦法的辦法吧。在編輯器設置里你還能看到一個類似的注解。
為什么 print "Hi # there." 里的 # 沒被忽略掉？
這行代碼里的 # 處於字符串內部，所以它就是引號結束前的字符串中的一部分，這時它只是一個普通字符，而不代表注解的意思。
怎樣做多行注解？
每行前面放一個 # 就可以了。
為什么要讓我倒着閱讀代碼？
這樣可以避免讓你的大腦跟着每一段代碼內容的意思走，這樣可以讓你精確處理每個片段，從而讓你更容易地發現代碼中的錯誤。這是一個很好使的查錯技巧。
參考文獻：《笨辦法學習Python》
感謝您閱讀上海尚學堂python培訓文章，更多內容或支持請點擊 上海python培訓