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

 更新时间:2026年08月31日 15:28:36   作者:韩公子的Linux大集市  
强制缩进的设计让 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("本次节点巡检完成")  # 不缩进,属于主程序代码块,无论条件如何都执行

上述运维场景代码中:

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

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

Python 缩进的词法规则

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

  • 同一代码块内的所有语句必须使用相同的缩进方式(同为空格的组合或同为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. 冒号与代码块开启

冒号 : 是代码块的开启标志。ifelifelseforwhiledefclasstryexceptwith 等复合语句的末尾必须加冒号,下一行开始缩进编写内部代码。

# 常见的代码块开启语句
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 或不同数量的空格,从而引发难以察觉的 IndentationErrorTabError

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

最佳实践:在编辑器中开启“显示空白字符(Render Whitespace)”功能,或设置保存时自动将 Tab 转为空格,从根源避免上述问题。企业运维脚本入库前必须执行 python -m py_compileflake8 做格式校验。

编辑器与工具配置

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

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 sizeIndent 均设置为 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的行号

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

下面是一个真实的批量巡检脚本,综合演示了 forifelifelse 的多层嵌套缩进:

# 批量检查多台主机的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("批量巡检完成")  # 主程序层级,始终执行

运行输出:

[WARN] 192.168.1.10 CPU使用率 85%,超过阈值
[WARN] 仅CPU超标,建议扩容或迁移
[WARN] 192.168.1.11 内存使用率 92%,需要关注
[INFO] 192.168.1.12 资源正常
批量巡检完成

观察重点:内层 if 通过增加 4 个空格形成第三级缩进,与内层 else 严格对齐;外层循环结束后,print 回归主程序层级。任何一行的缩进错位都会导致逻辑错误或 IndentationError

小结

  • Python 通过缩进标识代码块边界,冒号 : 是代码块的开启标志;
  • 同一代码块必须使用一致的缩进方式,绝对宽度不限,但必须保持相对一致性;
  • PEP 8 规范要求每级缩进 4 个空格,同一文件内禁止 Tab 与空格混用;
  • 空代码块使用 pass 占位;
  • 常见缩进错误包括:缩进量不一致、该缩进未缩进、过度缩进、Tab/空格混用、复制粘贴引入隐藏字符;
  • 通过编辑器配置和 flake8 等工具,可以在编码阶段就拦截绝大多数缩进问题。

到此这篇关于一文带你深入了解Python中的代码缩进规则的文章就介绍到这了,更多相关Python代码缩进内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 基于Tensorflow一维卷积用法详解

    基于Tensorflow一维卷积用法详解

    这篇文章主要介绍了基于Tensorflow一维卷积用法详解,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-05-05
  • Python 异步协程函数原理及实例详解

    Python 异步协程函数原理及实例详解

    这篇文章主要介绍了Python 异步协程函数原理及实例详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2019-11-11
  • 深入理解Django的中间件middleware

    深入理解Django的中间件middleware

    这篇文章主要给大家介绍了关于Django中的中间件middleware的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧。
    2018-03-03
  • python交互式图形编程实例(二)

    python交互式图形编程实例(二)

    这篇文章主要为大家详细介绍了python交互式图形编程实例,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-11-11
  • 深入浅析python3 依赖倒置原则(示例代码)

    深入浅析python3 依赖倒置原则(示例代码)

    今天通过园区停车信息这样一个场景分析python3 依赖倒置原则,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
    2021-07-07
  • python 异常捕获详解流程

    python 异常捕获详解流程

    异常即非正常状态,在Python中使用异常对象来表示异常。若程序在编译或运行过程中发生错误,程序的执行过程就会发生改变,抛出异常对象,程序流进入异常处理。如果异常对象没有被处理或捕捉,程序就会执行回溯(Traceback)来终止程序
    2022-03-03
  • pytorch ssim计算详细代码例子

    pytorch ssim计算详细代码例子

    这篇文章主要给大家介绍了关于pytorch ssim计算的相关资料,结构相似性(SSIM)是一种测量两幅图像的相似度的方法,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2023-12-12
  • Python之Await 协议的实现

    Python之Await 协议的实现

    本文主要介绍了Python之Await 协议的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2026-05-05
  • 只需要100行Python代码就可以实现的贪吃蛇小游戏

    只需要100行Python代码就可以实现的贪吃蛇小游戏

    贪吃蛇小游戏相信80、90后小时候肯定都玩过,那么你知道如果通过Python来实现吗?今天就来教大家,文中有非常详细的代码示例,对正在学习python的小伙伴们很有帮助,需要的朋友可以参考下
    2021-05-05
  • 教你用 Python 发送告警通知到微信的操作过程

    教你用 Python 发送告警通知到微信的操作过程

    大家都知道常见的告警方式有:邮件,电话,短信,微信,今天通过本文给大家介绍下Python 发送告警通知到微信的操作过程,感兴趣的朋友一起看看吧
    2022-01-01

最新评论