【Python入门系列】第2讲：注释与变量的全面解析（2026最新版）
这一讲我们来彻底搞懂Python中最基础却又非常重要的两个内容：注释 和 变量。
掌握好它们，你才能写出清晰、可读、可维护的代码，尤其是在团队协作和AI辅助开发时代，好的注释和变量命名直接决定代码质量。
1. 注释（Comments）—— 写给“人”看的代码
Python解释器会完全忽略注释，所以注释不会影响程序运行，但对人类（包括你自己三个月后）非常重要。
（1）单行注释
使用 # 开头，从 # 到行尾的内容都是注释。
# 这是一行单行注释
print("Hello, Python!") # 这也是单行注释，可以放在代码后面
# print("这行代码不会执行") # 被注释掉的代码不会运行
最佳实践：
- 注释要说明“为什么”，而不是“做了什么”。
- 差：
x = x + 1 # x加1 - 好：
x = x + 1 # 每完成一次任务，计数器加1
（2）多行注释（块注释）
Python没有真正的多行注释符号，常用两种方式：
方式1：使用多个 #
# ========================
# 这是一个功能模块的说明
# 作者：重阳
# 日期：2026-03-24
# 功能：计算用户总积分
# ========================
方式2：使用三个引号（最常用，推荐）
三个单引号 ''' 或三个双引号 """ 可以创建多行字符串，常用来做文档字符串（docstring）。
"""
这是一个多行注释 / 文档字符串
可以写很多行
函数功能：计算两个数的和
参数：
a: 第一个数
b: 第二个数
返回值：两数之和
"""
def add(a, b):
return a + b
注意：文件开头或函数/类开头的 """ 会被Python解释器识别为 docstring，可以通过 help() 或 __doc__ 属性查看，非常有用。
（3）注释的最佳实践（2026年建议）
- 注释比例：通常控制在代码的20%-30%。
- 使用中文注释完全没问题（Python3默认UTF-8）。
- 在复杂逻辑、重要决策、TODO、FIXME处一定要注释。
- AI生成代码后，一定要自己添加或修改注释，让代码更有“人味”。
2. 变量（Variables）—— 数据的“名字”
变量就是给数据起一个名字，方便后面反复使用。
（1）变量的定义和赋值
Python中变量不需要提前声明类型，直接赋值即可。
name = "重阳" # 字符串
age = 25 # 整数
height = 1.78 # 浮点数
is_student = True # 布尔值
scores = [95, 88, 92] # 列表
动态类型：同一个变量可以随时改变类型。
x = 10
print(x) # 10
x = "现在变成字符串了"
print(x) # 现在变成字符串了
（2）变量命名规则（必须遵守）
- 只能由 字母、数字、下划线 组成
- 不能以数字开头
- 不能使用Python关键字（如
if、for、def、class、and、or等） - 区分大小写：
Age和age是两个不同变量
推荐命名风格（PEP 8 官方规范）：
- 变量名：小写字母 + 下划线（snake_case）
- 好：
user_name,total_score,max_retry_count - 差：
UserName,totalScore,a,x1 - 常量：全部大写 + 下划线
MAX_CONNECTIONS = 100PI = 3.14159
好命名原则（非常重要！）：
- 见名知意（Descriptive）
- 不要太短（除非是循环里的
i、j） - 不要用中文拼音（除非团队统一要求）
- 避免歧义：
data、result、temp这种太泛的尽量不用
（3）同时给多个变量赋值（Python特色）
a = b = c = 0 # 三个变量同时赋值为0
x, y, z = 10, 20, 30 # 解包赋值
name, age, city = "重阳", 25, "Brussels"
（4）变量的底层原理（帮助你理解）
Python中一切皆对象。变量其实是一个引用（指针），指向内存中的对象。
a = 100
b = a # b指向和a相同的对象
print(id(a)) # 查看内存地址
print(id(b))
小整数（-5~256）和短字符串会被Python缓存复用，所以 id() 可能相同。
3. 综合小练习（立刻动手）
# 1. 写一段带注释的代码
"""
程序功能：计算圆的面积
作者：你的名字
日期：2026年3月
"""
import math
# 常量（大写）
PI = math.pi
radius = 5.0
# 计算面积
area = PI * radius ** 2
print(f"半径为 {radius} 的圆面积是 {area:.2f}")
4. 本讲总结（口诀记忆）
注释：# 单行注释，""" 多行文档字符串
好注释写“为什么”，坏注释只写“做了什么”
变量：
动态类型 + snake_case命名
见名知意 + 避免关键字 + 可同时赋值
一句话本质：
注释是写给人看的，变量是数据的标签。
写代码时先想清楚“这个变量代表什么”，再想“要不要加注释说明为什么这么做”。
下一讲预告：
Python入门第3讲：数据类型与基本运算符全面详解
我们将深入讲解数字、字符串、布尔值，以及 + - * / // % ** 等运算符，还会讲类型转换和输入输出。
立即练习：
- 写一个带详细注释的脚本，计算你的BMI指数（体重 / 身高²）。
- 定义至少10个有意义的变量（姓名、年龄、城市、爱好等），并打印出来。
- 尝试同时给多个变量赋值，并观察内存地址
id()的变化。
完成练习后，回复“练习完成”或直接把你的代码贴出来，我帮你检查和优化！
准备好了吗？
回复 “下一讲” 我们马上进入数据类型与运算符！
或者有任何关于注释、变量的疑问，现在就问我，我立刻解答！
继续加油！你已经在Python入门路上稳稳前进了！🐍✨
