Python入门：2.注释与变量的全面解析

【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: 第二个数 返回值：两数之和 """defadd(a,b):returna+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=10print(x)# 10x="现在变成字符串了"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 = 100
  • PI = 3.14159

好命名原则（非常重要！）：

• 见名知意（Descriptive）
• 不要太短（除非是循环里的i、j）
• 不要用中文拼音（除非团队统一要求）
• 避免歧义：data、result、temp这种太泛的尽量不用

（3）同时给多个变量赋值（Python特色）

a=b=c=0# 三个变量同时赋值为0x,y,z=10,20,30# 解包赋值name,age,city="重阳",25,"Brussels"

（4）变量的底层原理（帮助你理解）

Python中一切皆对象。变量其实是一个引用（指针），指向内存中的对象。

a=100b=a# b指向和a相同的对象print(id(a))# 查看内存地址print(id(b))

小整数（-5~256）和短字符串会被Python缓存复用，所以id()可能相同。

3. 综合小练习（立刻动手）

# 1. 写一段带注释的代码""" 程序功能：计算圆的面积 作者：你的名字 日期：2026年3月 """importmath# 常量（大写）PI=math.pi radius=5.0# 计算面积area=PI*radius**2print(f"半径为{radius}的圆面积是{area:.2f}")

4. 本讲总结（口诀记忆）

注释：
#单行注释，"""多行文档字符串
好注释写“为什么”，坏注释只写“做了什么”

变量：
动态类型 + snake_case命名
见名知意 + 避免关键字 + 可同时赋值

一句话本质：
注释是写给人看的，变量是数据的标签。
写代码时先想清楚“这个变量代表什么”，再想“要不要加注释说明为什么这么做”。

下一讲预告：
Python入门第3讲：数据类型与基本运算符全面详解
我们将深入讲解数字、字符串、布尔值，以及+ - * / // % **等运算符，还会讲类型转换和输入输出。

立即练习：

1. 写一个带详细注释的脚本，计算你的BMI指数（体重 / 身高²）。
2. 定义至少10个有意义的变量（姓名、年龄、城市、爱好等），并打印出来。
3. 尝试同时给多个变量赋值，并观察内存地址id()的变化。

完成练习后，回复“练习完成”或直接把你的代码贴出来，我帮你检查和优化！

准备好了吗？
回复“下一讲”我们马上进入数据类型与运算符！
或者有任何关于注释、变量的疑问，现在就问我，我立刻解答！

继续加油！你已经在Python入门路上稳稳前进了！🐍✨