Python基础语法入门：变量命名、缩进规则与注释规范

学习 Python 编程的第一步，并非死记硬背复杂的算法，而是准确掌握其最底层的基本语法规则。Python 语言以语法简洁、可读性强著称，而这种优势完全建立在严谨的排版与书写约定之上。初学者在编写第一行代码时，最容易遭遇的语法报错通常并非逻辑问题，而是由变量命名不合规、空格缩进不对齐以及注释格式疏漏引起的。本文直接聚焦 Python 语法的这三大基石：变量命名、缩进规则与注释规范，系统梳理底层的语法限制条件与工程推荐标准，帮助读者快速写出规范、无错且易于维护的代码。

一、变量命名的硬性规则与 PEP 8 风格规范

在 Python 中，变量是内存中数据的引用标签。定义变量时，标识符（Identifier）的选取直接决定了解释器能否正确解析。变量命名分为两个层级：必须严格遵守的底层语法规则（违反则抛出语法错误 SyntaxError），以及团队协作中应当遵循的 PEP 8 官方编码风格规范。

1. 底层语法强制规则（不可违反）

• 组成字符限制：变量名只能包含大小写英文字母（a-z、A-Z）、数字（0-9）和下划线（_）。虽然 Python 3 原生支持 Unicode 字符（如中文变量名），但工程实践中严禁使用非英文字符。
• 开头字符限制：变量名首字符必须是字母或下划线，绝对不能以数字开头。例如 1st_number 是非法语法，而 number_1st 或 _first_number 是合法的。
• 严格区分大小写：username、UserName 和 USERNAME 代表三个完全独立的变量。
• 禁止占用系统关键字：Python 保留了约 35 个特定关键字（如 if、def、class、return、import 等），不得将其用作变量名。同时应避免覆盖内置函数名（如 print、list、str、type）。

2. PEP 8 命名规范（良好实践）

• 蛇形命名法（snake_case）：普通变量名与函数名全部采用小写字母，单词之间使用单个下划线分隔，例如 student_score、user_login_count。
• 全大写常量（UPPER_CASE）：在 Python 中没有语言级别的常量语法，通常通过将全部字母大写来表示逻辑常量，例如 MAX_CONNECTIONS = 100、DEFAULT_TIMEOUT = 30。
• 帕斯卡命名法（PascalCase）：类名采用首字母大写的驼峰格式，如 UserManager、HttpRequestHandler。
• 见名知意：拒绝使用无意义的单字母（除循环计数器 i、j 外），避免使用易混淆字符（小写 l 与数字 1、大写 O 与数字 0）。

图 1：Python 变量命名合法性与风格决策流程

3. 变量命名常见正反例速查

二、Python 缩进规则与代码块层级

与 C、C++、Java、JavaScript 等通过花括号 {} 划定代码作用域的语言不同，Python 使用强制缩进来界定代码块（Code Block）。这种设计从语言层面强制了代码的整齐划一，但也要求开发者必须对缩进规则保持高度严谨。

1. 缩进的运行机制与冒号原则

在 Python 中，复合语句（如 if、for、while、def、class、try 等）均以英文冒号 : 结尾。冒号之后紧随其后的新行，必须增加相对缩进，这标志着一个子代码块的开始；当缩进回退到前一级的缩进量时，代表该代码块的结束。

# 示例：通过缩进体现层次结构
def calculate_discount(price, is_member):
    # 缩进层级 1：属于函数体（4 个空格）
    if price >= 100:
        # 缩进层级 2：属于 if 分支（8 个空格）
        if is_member:
            # 缩进层级 3：属于嵌套的 member 分支（12 个空格）
            final_price = price * 0.8
        else:
            final_price = price * 0.9
    else:
        final_price = price
    
    # 回退到层级 1：属于函数体
    return final_price

2. PEP 8 推荐缩进标准：4 个空格

官方 PEP 8 明确规定：Python 代码必须使用 4 个纯空格（Spaces）作为一个缩进层级。

• 绝对禁止混用 Tab 与空格：在 Python 3 中，混合使用制表符（Tab）和空格会直接触发 TabError: inconsistent use of tabs and spaces in indentation 运行时异常。因为不同编辑器对 Tab 宽度的解释可能为 2、4 或 8 个空格，肉眼看起来对其的代码在解释器眼中缩进完全错位。
• IDE 实用配置：在 PyCharm、VS Code 等现代编辑器中，务必开启“将 Tab 键自动转换为空格”（Insert Spaces Instead of Tabs），并将 Tab Size 设为 4。
• 同行缩进必须严格一致：位于同一个代码块内的所有语句，其缩进的空格数量必须绝对相同，哪怕多一个或少一个空格都会导致 IndentationError: unexpected indent 或 unindent does not match any outer indentation level。

图 2：Python 缩进层级与代码块结构解析

三、注释规范与工程注释实践

注释是代码的重要组成部分，其核心价值在于解释“为什么这样做”（Why），而非机械复述代码“做了什么”（What）。合理的注释能够极大降低代码维护成本。Python 提供了单行注释、行尾注释、多行注释以及文档字符串（Docstring）四种常见形态。

1. 单行注释与块注释（#）

• 基本格式：单行注释以井号 # 开头，后跟一个半角空格，再写注释文本。例如：# 计算订单总金额。
• 独立块注释：若针对下方整段代码进行说明，注释应置于该段代码的上方，缩进层级与其所修饰的代码严格保持一致。
• 段落分隔：在复杂的长函数内部，不同逻辑块之间建议保留一个空行，并在新逻辑开头使用单行注释说明该段业务意图。

2. 行尾注释（Inline Comments）

行尾注释位于代码语句的同一行末尾。规范要求：

• 代码末尾与 # 之间必须至少保留两个半角空格（避免代码与注释贴在一起）。
• # 之后保留一个空格，然后书写注释内容。
• 仅用于对特定非常规语句进行极其简练的说明，切勿滥用或在每一行末尾都堆砌无价值的行尾注释。

# 正确的行尾注释范式：间隔至少两个空格，#后空一格
status_code = 404  # 资源不存在，触发兜底回退页面
retry_count = 3    # 限制网络抖动时的最大重试次数

3. 文档字符串（Docstring / 三引号）

文档字符串使用三对双引号 """ 或单引号 ''' 包裹（PEP 8 强烈推荐统一使用双引号 """）。与普通被解释器忽略的注释不同，Docstring 是 Python 对象的内建元属性，可以通过 help() 函数或 __doc__ 属性实时读取，并能被自动化文档工具（如 Sphinx）直接解析导出。

• 放置位置：必须紧跟在模块、类定义（class）或函数定义（def）的第一行。
• 内容组成：包括功能一句话简述、详细描述、参数说明（Args）、返回值说明（Returns）以及可能抛出的异常（Raises）。

图 3：Python 注释类型与放置规范架构图

四、三大核心语法要素综合示例与速查

为了让读者直观理解变量命名、代码缩进与注释规范如何有机结合，以下提供一段标准的订单折扣核算函数。该函数严格遵从 PEP 8 规范，展示了标准工程级 Python 代码的排版全貌：

# -*- coding: utf-8 -*-
"""电商交易模块：订单价格与权益核算服务。

本脚本用于演示 PEP 8 命名规范、严格四空格缩进以及多级注释规范的协同应用。
"""

# 全局常量定义：使用全大写字母与下划线命名
MAX_DISCOUNT_RATIO = 0.50   # 平台风控允许的最大折扣比例
DEFAULT_CURRENCY = "CNY"    # 默认结算货币代码


def calculate_order_total(original_price, user_level, coupon_amount=0):
    """计算扣除会员折扣与优惠券后的最终应付金额。

    参数:
        original_price (float): 订单原价，必须大于 0。
        user_level (int): 用户会员等级（1 为普通，2 为黄金，3 为钻石）。
        coupon_amount (float, 可选): 优惠券抵扣面额，默认为 0。

    返回:
        float: 最终应付金额（四舍五入保留两位小数）。

    抛出:
        ValueError: 当 original_price 小于或等于 0 时抛出。
    """
    # 步骤 1：入参基础校验（缩进层级 1：4 个空格）
    if original_price <= 0:
        raise ValueError("订单原价必须为大于0的正数")

    # 步骤 2：根据会员等级决定基础折扣率
    # 会员折扣字典映射，避免大量臃肿的 if-elif 嵌套
    level_discount_map = {
        1: 1.00,  # 普通会员：原价无折扣
        2: 0.90,  # 黄金会员：享 9 折
        3: 0.80   # 钻石会员：享 8 折
    }
    
    # 获取用户对应的折扣率，若等级未命中则按 1.0（无折扣）兜底
    discount_ratio = level_discount_map.get(user_level, 1.00)

    # 步骤 3：核算折后价格（缩进层级 1：4 个空格）
    discounted_price = original_price * discount_ratio

    # 扣减优惠券金额
    final_payable = discounted_price - coupon_amount

    # 步骤 4：兜底安全校验（缩进层级 1 与层级 2 的配合）
    min_allowable_price = original_price * (1.0 - MAX_DISCOUNT_RATIO)
    if final_payable < min_allowable_price:
        # 触发风控底线：折扣后金额不得低于平台允许的最低红线
        final_payable = min_allowable_price  # 保护商家成本底线

    return round(final_payable, 2)


# 模块主程序入口与执行示例
if __name__ == "__main__":
    test_price = 200.0
    test_vip_level = 2
    coupon_value = 15.0

    # 调用核算接口并打印结果
    actual_payment = calculate_order_total(test_price, test_vip_level, coupon_value)
    print(f"原价: ¥{test_price}, 实付: ¥{actual_payment}")

图 4：Python 基础语法三大核心要素综合速查矩阵

五、常见问题排查与避坑要点

def fetch_remote_data():
    pass  # 临时占位，防止抛出 expected an indented block 异常

综上所述，变量命名赋予代码准确清晰的表达能力，缩进规则支撑起严谨有序的逻辑执行框架，而注释规范则赋予代码长期维护与团队沟通的生命力。掌握并践行这三大基础语法规范，是每一位 Python 开发者编写健壮、专业代码的必由之路。