一文带你深入了解Python中的代码缩进规则_Python

准确性检查结果

原文整体正确、结构清晰，但存在三处需要修正或精确化的表述：

位置	原文表述	问题	修正建议
标准缩进规范	“禁止使用tab键”	语法上不准确。python 语法只要求同一代码块内缩进方式一致，单独使用 tab 是合法的；pep 8 推荐且团队规范禁止混用，但不应表述为语法禁止	“不建议使用tab，同一代码块内禁止tab与空格混用”
长语句换行缩进	“无括号时统一缩进4个空格”	不全面。pep 8 要求悬挂缩进优先与括号内第一个非空白字符对齐；无括号且使用反斜杠续行时可缩进4空格，但必须保持整份文件一致	推荐括号内垂直对齐，反斜杠续行使用4空格并保持一致
长表达式示例	`total_available = (cpu_total + memory_total + disk_total` 换行后的 `- reserved_cpu` 未与括号内起始字符对齐	虽然运行无误，但不符合 pep 8 的垂直对齐要求	改为与 `cpu_total` 对齐，或使用4空格悬挂缩进

另外可补充两个原文缺失的重要知识点：空代码块必须用 pass 占位、taberror 的具体报错信息。

python 缩进规则与代码块

代码块与缩进的作用

代码块是一组在逻辑上属于同一层级、共同执行的代码语句，是流程控制的基本单元。在 c、java 等语言中，使用花括号 {} 包裹代码块；而 python 采用缩进（indentation）来标识代码块的边界，这是 python 最显著的语法特点之一。

缩进的本质是通过行首的空白字符，标识代码的嵌套层级。同一层级的代码必须保持相同的缩进量：缩进量增加代表进入一个内层代码块，缩进量减少代表退出当前代码块。

cpu_usage = 85
if cpu_usage >= 80:
    # 缩进4个空格，属于if的内部代码块
    print("[warn] cpu使用率超过阈值")
    print("触发二级告警，记录运维日志")
else:
    print("[info] cpu使用率正常")
    print("无需人工干预")
print("本次节点巡检完成")  # 不缩进，属于主程序代码块，无论条件如何都执行

上述运维场景代码中：

if 与 else 下缩进的两行代码，只有满足对应阈值条件才会执行；
最后一行没有缩进，属于主程序层级，始终会执行，代表巡检流程结束。

强制缩进的设计让 python 运维脚本具有极强的可读性，所有开发者写出的自动化脚本结构风格高度统一，避免了不同程序员括号风格差异带来的阅读障碍，非常适合团队协作的运维自动化场景。

python 缩进的词法规则

python 解释器在解析源码时，并不是简单地将缩进视为“排版格式”，而是将其作为语法标记处理。当词法分析器遇到行首空白时，会生成 indent 和 dedent 记号，用来表示代码块的进入和退出。因此：

同一代码块内的所有语句必须使用相同的缩进方式（同为空格的组合或同为tab）；
缩进的绝对宽度不要求固定，但相对一致性是硬性要求。例如第一行缩进 2 个空格、第二行缩进 4 个空格，在语法上并不等价；
代码的顶层内容必须顶格书写，不能有任何缩进。

# 语法上合法但极不推荐的缩进写法（仅作原理演示）
if true:
  print("2个空格")
  print("仍然2个空格")

# 语法错误：同一代码块缩进量不一致
if true:
  print("2个空格")
    print("4个空格")   # indentationerror

这一设计将代码块边界直接暴露在视觉层面，杜绝了“括号写在行尾还是行首”的争议，也避免了多余或缺失的右括号导致的隐蔽逻辑错误。代价是开发者必须严格遵守缩进规范，否则程序无法运行。

标准缩进规范

根据 python 官方 pep 8 编码规范，结合企业运维脚本开发规范，缩进需遵循以下标准：

1. 缩进单位：4个空格

每一层级的代码块统一缩进 4 个空格，这是官方推荐的标准。在团队协作中应明确约定：使用空格作为唯一缩进字符，所有编辑器统一配置 tab 键自动转换为 4 个空格。

关键提示：不同编辑器中 tab 的宽度可能不同（4 空格、8 空格不等），混用 tab 和空格会直接触发 taberror。企业级运维开发中强烈建议在编辑器中开启“将 tab 自动替换为空格”，保证所有脚本格式统一。

2. 层级对齐规则

同一逻辑层级的代码，必须严格左对齐，缩进量完全相同。不同嵌套层级的代码，缩进量逐层递增 4 个空格。

# 多层嵌套时的缩进层级
def check_all_services():
    """遍历所有服务并检查状态（函数体缩进1级）"""
    services = ["nginx", "mysql", "redis"]
    for service in services:                # 缩进1级
        status = get_status(service)        # 缩进2级
        if status == "running":             # 缩进2级
            print(f"[ok] {service}")        # 缩进3级
        else:
            print(f"[err] {service}")       # 缩进3级
            restart_service(service)        # 缩进3级

3. 冒号与代码块开启

冒号 : 是代码块的开启标志。if、elif、else、for、while、def、class、try、except、with 等复合语句的末尾必须加冒号，下一行开始缩进编写内部代码。

# 常见的代码块开启语句
if condition:        # 条件判断
    ...

for item in items:   # 遍历
    ...

def func():          # 函数定义
    ...

try:                 # 异常处理
    ...
except exception:
    ...

4. 空代码块必须使用 pass

如果某个代码块暂时不需要执行任何操作，语法上仍要求至少包含一条语句。此时应使用 pass 作为空占位语句，避免 indentationerror。

if config.get("maintenance_mode"):
    pass  # 维护模式下暂不执行任何操作，后续版本迭代补充
else:
    run_scheduled_tasks()

5. 长语句换行缩进

当一行代码过长需要换行时，优先使用括号将表达式包裹起来，换行后的代码应与括号内的起始字符垂直对齐；若无法对齐，则统一缩进 4 个空格，并保持整份文件风格一致。

# 推荐：括号内垂直对齐
total_available = (cpu_total + memory_total + disk_total
                   - reserved_cpu - reserved_memory - buffer_disk)

# 推荐：使用反斜杠续行（无括号场景），后续行缩进4空格
deploy_command = "ansible-playbook -i prod/hosts deploy.yml " \
    "--tags=web --extra-vars=version=1.4.2"

# 不推荐：混用多种缩进方式
total = (cpu_total + memory_total
       - disk_total)   # 与上方括号起始位置不对齐

常见缩进错误

缩进错误是 python 运维新手最常遇到的语法错误，常见错误类型可归纳为以下五类：

1. 缩进量不一致

同一层级的代码缩进空格数不同，触发 indentationerror。

# 错误示例：告警逻辑缩进不一致
if cpu_usage >= 80:
    print("[warn] cpu超标")
      print("写入告警日志")  # 6个空格，与上一行缩进不一致

报错信息：

indentationerror: unexpected indent

2. 该缩进时未缩进

冒号后必须开启代码块，下一行必须缩进，否则报错。

# 错误示例：条件后未缩进
if service_status == "fault":
print("[error] 服务异常")  # 没有缩进，不属于if代码块

报错信息：

indentationerror: expected an indented block

3. 不该缩进时过度缩进

不属于内层代码块的语句错误增加缩进，导致逻辑错误（语法不报错，但运行结果不符合预期）。

# 错误示例：每次循环都会打印“单台巡检完成”
for host in host_list:
    check_host_health(host)
    print("单台巡检完成")   # 缩进后变成循环体内部语句

正确写法是将 print("单台巡检完成") 取消缩进，放在循环外部，所有主机巡检完后执行一次：

for host in host_list:
    check_host_health(host)
print("单台巡检完成")        # 循环结束后执行

4. tab 与空格混用

肉眼看起来缩进一致，但实际混合了 tab 和空格，解释器识别为不同缩进。该错误在 python 3 中会直接抛出 taberror，排查难度较高。

# 错误示例：第一行使用tab，第二行使用4个空格
if cpu_usage >= 80:
	print("[warn] cpu超标")   # 按下tab键输入
    print("写入告警日志")      # 输入4个空格

报错信息：

taberror: inconsistent use of tabs and spaces in indentation

5. 复制粘贴导致的混合缩进

从网页、pdf、聊天工具中复制代码到编辑器时，行首空白可能被自动转换为全角空格、tab 或不同数量的空格，从而引发难以察觉的 indentationerror 或 taberror。

# 看似对齐，实际某一行行首包含了全角空格
if status == "ok":
　print("正常")       # 全角空格，报错 unexpected indent
    print("继续执行")

最佳实践：在编辑器中开启“显示空白字符（render whitespace）”功能，或设置保存时自动将 tab 转为空格，从根源避免上述问题。企业运维脚本入库前必须执行 python -m py_compile 和 flake8 做格式校验。

编辑器与工具配置

为保证团队所有成员的脚本格式一致，推荐在主流编辑器中统一设置。

vs code 配置（settings.json）

{
  "editor.insertspaces": true,
  "editor.tabsize": 4,
  "editor.detectindentation": false,
  "editor.renderwhitespace": "all"
}

pycharm 配置

进入 settings → editor → code style → python → tabs and indents：

将 tab size 和 indent 均设置为 4；
取消勾选 use tab character；
勾选 detect and use existing file indents for editing 关闭。

vim / neovim 配置

set expandtab       " 将tab自动展开为空格
set tabstop=4       " tab键宽度
set shiftwidth=4    " 自动缩进宽度
set smarttab

命令行验证脚本语法

python3 -m py_compile deploy_check.py   # 语法检查，无输出即通过
flake8 deploy_check.py                  # 风格检查，输出不符合pep8的行号

综合示例：多层缩进在运维自动化中的应用

下面是一个真实的批量巡检脚本，综合演示了 for、if、elif、else 的多层嵌套缩进：

# 批量检查多台主机的cpu与内存状态
hosts = {
    "192.168.1.10": {"cpu": 85, "mem": 50},
    "192.168.1.11": {"cpu": 30, "mem": 92},
    "192.168.1.12": {"cpu": 40, "mem": 35},
}
cpu_threshold = 80
mem_threshold = 90

for host, metrics in hosts.items():
    cpu = metrics["cpu"]
    mem = metrics["mem"]

    if cpu >= cpu_threshold:
        print(f"[warn] {host} cpu使用率 {cpu}%，超过阈值")
        if mem >= mem_threshold:
            print(f"[critical] {host} cpu和内存双双超标，立即处理")
        else:
            print(f"[warn] 仅cpu超标，建议扩容或迁移")
    elif mem >= mem_threshold:
        print(f"[warn] {host} 内存使用率 {mem}%，需要关注")
    else:
        print(f"[info] {host} 资源正常")

print("批量巡检完成")  # 主程序层级，始终执行

运行输出：