介绍
注释是存在于计算机程序中被编译器和解释器忽略的行。在程序中包含注释使得代码对于人类更可读，因为它提供了关于程序的每个部分正在做什么的一些信息或解释。 根据程序的目的，注释可以作为自己或提醒的注释，也可以写成其他程序员能够理解你的代码在做什么。 一般来说，在写入或更新程序时写下注释是个好主意，因为稍后很容易忘记你的思维过程，后面写的注释在长期内可能不太有用。注释语法
Python中的注释以哈希标记（# ）和空格字符开头，并继续到行的结尾。 一般来说，注释看起来像这样：
# This is a comment
hello.py
# Print “Hello, World!” to console
print("Hello, World!")
for循环中，注释可能如下所示：
sharks.py
# Define sharks variable as a list of strings
sharks = ['hammerhead', 'great white', 'dogfish', 'frilled', 'bullhead', 'requiem']
# For loop that iterates over sharks list and prints each string item
for shark in sharks:
print(shark)
again()函数被注释，在代码的每个缩进级别后面的注释：
calculator.py
...
# Define again() function to ask user if they want to use the calculator again
def again():
# Take input from user
calc_again = input('''
Do you want to calculate again?
Please type Y for YES or N for NO.
''')
# If user types Y, run the calculate() function
if calc_again == 'Y':
calculate()
# If user types N, say good-bye to the user and end the program
elif calc_again == 'N':
print('See you later.')
# If user types another key, run the function again
else:
again()
块注释
块注释可以用来解释更复杂的代码或代码，你不希望读者熟悉。这些较长形式的注释适用于随后的部分或全部代码，并且也缩进为与代码相同的级别。 在块注释中，每行以哈希标记和单个空格开头。如果您需要使用多个段落，它们应该由包含单个散列标记的线分隔。 下面是一个块注释的例子，它定义了下面定义的main()函数中发生的事情：
# The main function will parse arguments via the parser variable. These
# arguments will be defined by the user on the console. This will pass
# the word argument the user wants to parse along with the filename the
# user wants to use, and also provide help text if the user does not
# correctly pass the arguments.
def main():
parser = argparse.ArgumentParser()
parser.add_argument(
"word",
help="the word to be searched for in the text file."
)
parser.add_argument(
"filename",
help="the path to the text file to be searched through"
)
...
内联注释
内联注释发生在语句的同一行，跟在代码本身后面。像其他注释一样，它们以哈希标记和单个空格字符开头。 一般来说，内联注释看起来像这样：[code] # Inline comment about the code
z = 2.5 + 3j # Create a complex number
x = 8 # Initialize x with an arbitrary number
注释测试代码
除了使用注释作为文档代码的方式之外，哈希标记还可以用于注释掉在您正在创建的程序测试或调试期间不想执行的代码。也就是说，当您在实施新代码之后遇到错误时，您可能需要评论其中的一些，以查看您是否可以排查疑难问题。 使用哈希标记还可以让您在确定如何设置代码时尝试替代方法。例如，你可能决定在Python游戏中使用while循环或
for循环，并且可以在测试和确定哪个可能是最好的时候注释掉一个或另一个：
guess.py
import random
number = random.randint(1, 25)
# number_of_guesses = 0
for i in range(5):
# while number_of_guesses < 5:
print('Guess a number between 1 and 25:')
guess = input()
guess = int(guess)
# number_of_guesses = number_of_guesses + 1
if guess < number:
print('Your guess is too low')
if guess > number:
print('Your guess is too high')
if guess == number:
break
if guess == number:
print('You guessed the number!')
else:
print('You did not guess the number. The number was ' + str(number))
