1.单行注释
用井号开头,从井号到行尾的内容被 Python 忽略。
可单独一行,也可放在代码右侧。
2.多行注释
用三个单引号或三个双引号包裹,本质是多行字符串。
未被赋值时,Python 将其忽略,效果等同注释。
3.单行注释与多行注释的区别
单行注释每行需加井号,适合短说明和临时禁用代码。
多行注释用一对三引号包裹整段,适合长篇说明,但不能嵌套。
4.注释的用途
解释“为什么”这样写,而非重复代码“做了什么”。
帮助阅读者理解代码意图、业务逻辑或标记待办事项。
5.调试用注释
在代码行前面加井号可临时禁用该行,使其不执行。
用于排查问题时快速定位错误来源。
6.文档字符串
放在函数、类、文件开头的三引号注释。
Python 会将其存入对象的 doc 属性,可通过 help() 查看。
7.三引号注释不能嵌套
Python 遇到三个引号即视为注释开始或结束,不区分层级。
内部再出现相同引号会提前终止注释,导致语法错误。
8.注释不执行
Python 解释器完全忽略所有注释内容,注释不会影响程序运行结果,也不会输出到屏幕。
实例1
# 程序:计算圆的面积
# 作者:可爵
# 日期:2026-06-06
'''
公式说明:
面积 = π × 半径的平方π 取 3.14
'''
π=3.14
半径=5
面积=π*半径*半径#套用面积公式进行计算
print(面积)
print("程序开始")
# print("这行暂时禁用")
print("程序结束")def 打招呼():
'''向用户发出问候语,并返回问候字符串'''
问候 = "你好,欢迎!"
return 问候
print(打招呼())
print(打招呼.__doc__)