8.Python基本语法·注释——《跟老吕学Python编程》

Python 基本语法

注意，Python 基本语法包含了编码、标识符、保留字、注释、缩进、字符串等常用内容，是后续学习的基础和预览，是极其重要的，老吕希望大家不要随意跳过本文的学习！

Python注释是老吕要说的第一个重点，正是这样的注释才能让大家更快的学会Python。

Python的注释有单行注释和多行注释两种。

Python 中单行注释以#开头，后面跟着注释内容。
重注1：#和注释内容一般建议以一个空格隔开

print("Hello, World1!")
# 老吕写的第1个注释，想让电脑跟我说Hello, World1!

8.Python基本语法·注释——《跟老吕学Python编程》

运行显示：

Hello, World!

8.Python基本语法·注释——《跟老吕学Python编程》

Python代码后面也是可以直接写注释的
重注2：要运行的代码和#一般建议以两个空格隔开

# #符号后就是老吕写的第1个注释
print("Hello, World2!")  # 老吕写的第2个注释
# 老吕写的第3个注释：以上代码的目的是想让电脑跟我说Hello, World2!

8.Python基本语法·注释——《跟老吕学Python编程》
运行显示：

Hello, World2!

8.Python基本语法·注释——《跟老吕学Python编程》

Python代码后面也是可以写多行注释的
重注2：要运行的代码和#一般建议以两个空格隔开

print("Hello, World3!")
# 老吕写注释1
# 老吕写注释2
# 老吕写注释3
# 老吕写注释4

8.Python基本语法·注释——《跟老吕学Python编程》
运行显示：

Hello, World3!

8.Python基本语法·注释——《跟老吕学Python编程》

Python 使用三个连续的单引号(‘’')或者三个连续的双引号(“”")注释多行内容

'''
老吕写的第1个多行注释
3个单引号分别作为注释的开头和结尾
可以一次性注释多行内容
里面的内容全部都是注释内容
'''
print("你好，老吕")
"""
老吕写的第1个多行注释
3个双引号分别作为注释的开头和结尾
可以一次性注释多行内容
里面的内容全部都是注释内容
"""

8.Python基本语法·注释——《跟老吕学Python编程》
运行显示：

你好，老吕

8.Python基本语法·注释——《跟老吕学Python编程》

Python 多行注释不支持嵌套

老吕举个错误栗子1：

'''
外层注释
    '''
    内层注释
    '''
'''

8.Python基本语法·注释——《跟老吕学Python编程》
运行显示：

  File "C:\LVworks\LaoLv\cuowu1.py", line 4
    内层注释
IndentationError: unexpected indent

8.Python基本语法·注释——《跟老吕学Python编程》

不管是多行注释还是单行注释，当注释符作为字符串的一部分出现时，就不能再将它们视为注释标记，而应该看做正常代码的一部分。

老吕举个错误栗子2：

print('''你好老吕''')
print("""苍井空有点大""")
print("#是单行注释的开始，苍井空真的有点大")

8.Python基本语法·注释——《跟老吕学Python编程》
运行显示：

print('''你好老吕''')
print("""苍井空有点大""")
print("#是单行注释的开始，老吕你说的太夸张了，苍井空还没我大")

8.Python基本语法·注释——《跟老吕学Python编程》
对于第一和第二行代码，Python 没有将里面的三个引号看作是多行注释，而是将它们看作字符串的开始和结束标志。
对于第三行代码，Python 也没有将井号看作单行注释，而是将它看作字符串的一部分。

注释（Comments）用来向用户提示或解释某些代码的作用和功能，它可以出现在代码中的任何位置。Python 解释器在执行代码时会忽略注释，不做任何处理，就好像它不存在一样。
在调试（Debug）程序的过程中，注释还可以用来临时移除无用的代码。
注释的最大作用是提高程序的可读性，没有注释的程序简直就是天书，让人吐血！
千万不要认为你自己写的代码规范就可以不加注释，甩给别人一段没有注释的代码是对别人的不尊重，是非常自私的行为；你可以喜欢自虐，但请不要虐待别人。
老吕宁愿自己去开发一个应用，也不愿意去修改别人的代码，因为很多程序员编码习惯很差，没有合理的注释是一个重要的原因。虽然良好的代码可以自成文挡，但我们永远不清楚今后阅读这段代码的人是谁，他是否和你有相同的思路；或者一段时间以后，你自己也不清楚当时写这段代码的目的了。
一般情况下，合理的代码注释应该占源代码的 1/3 左右。
最后，重申一次：Python 支持两种类型的注释，分别是单行注释和多行注释。