写给 Python 初学者的编码规范指南：跟着 PEP8 写出漂亮代码

大家好，欢迎来到IT知识分享网。

刚学 Python 的你，是不是经常疑惑：”为什么别人的代码看起来整整齐齐？””缩进该用 Tab 还是空格？每行写多长合适？”别担心！Python 官方的 PEP8 规范就像一本 “代码美容手册”，帮你写出整洁易读的代码。今天我们就从初学者视角，用最通俗的语言聊聊这些实用规范。

一、代码的 “颜值基础”：格式规范

1. 缩进：代码的 “隐形分界线”

Python 靠缩进来区分代码块（比如循环、条件句、函数体），就像写作文要空两格，这是代码的 “排版底线”。

✅ 记住：永远用 4 个空格缩进（别用 Tab 键！不同电脑显示不一样会乱套）

# 正确示范：4个空格缩进，结构清晰 if temperature > 30: print("好热啊！") # 条件成立时执行 for i in range(3): # 循环体再缩进4格 print("扇扇子~") 

❌ 错误示范：混用 Tab 和空格（编辑器可能识别错误）

if temperature > 30: print("错误缩进！") # 这里用了Tab键，千万别学！ 

✨ 特殊情况：长代码换行时，可以 “悬挂缩进”（比上一行多 4 格）或对齐括号

# 两种优雅的换行方式 result = calculate( param1, # 悬挂缩进，每行多4格 param2, param3 ) result = calculate(param1, # 对齐括号起始位置 param2 param3) 

2. 行长：别让代码 “长太长”

total = item1 + item2 + item3 + # 运算符后面换行 item4 + item5 + item6 # 下一行缩进4格 

② 用括号包裹换行（圆括号 / 方括号 / 花括号内换行更自由）

# 列表太长换行，保持缩进一致 user_info = [ "张三", "20岁", "北京", "工程师", "Python爱好者" ] # 长字符串换行，用括号包裹更美观 message = ("今天天气不错，" "适合写代码~") 

3. 空行：给代码 “分段呼吸”

# 函数1（和函数2之间空2行） def greet(): print("你好！") # 简单功能，不用空行 # 函数2（和上面空2行） def say_hello(name): # 准备打招呼内容 message = f"你好，{name}！" # 前后逻辑相关，不用空行 # 输出信息（和上一行空1行，区分不同步骤） print(message) class User: # 方法1（和方法2之间空1行） def login(self): print("登录中...") # 方法2（和上面空1行） def logout(self): print("退出登录...") 

二、代码的 “名字艺术”：命名规范

好的变量名就像人的名字，一看就知道是做什么的！PEP8 规定了不同的命名风格：

❌ 避免这样写：

# 反例：变量名看不懂，类名用小写 a = 100 # 不知道a代表什么 def MyFunction(): # 函数名用驼峰，这是类的写法 pass 

✅ 正确示范：

student_score = 95 # 变量名清晰 def calculate_average(): # 函数名表示功能 pass class StudentManager: # 类名表示"这是一个管理学生的类" pass 

三、代码的 “说明书”：注释规范

注释是写给未来的自己和队友看的！三种常用注释要分清：

1. 块注释：解释一段代码的功能

放在代码块上方，每行以 #开头，和代码空 1 行，开头加空格

# 计算两个数的平均值 # 参数：a, b 两个数字 # 返回：平均值 def average(a, b): return (a + b) / 2 

2. 行注释：解释某一行代码的作用

写在代码末尾，# 前至少留 2 个空格，# 后留 1 个空格

count = 0 # 初始化计数器，从0开始 count += 1 # 每次循环计数器加1 

3. 文档字符串（Docstring）：给函数 / 类写 “使用说明”

用三个双引号 “”” 包裹，放在定义的第一行，说明功能、参数、返回值

def greet(name): """ 向指定的人打招呼 :param name: 要打招呼的人的名字（字符串类型） :return: 打招呼的消息（字符串类型） """ return f"你好，{name}！" 

四、导入语句：代码的 “食材采购清单”

# 标准库导入（第一组） import os import sys # 第三方库导入（第二组，和上面空1行） import requests # 本地模块导入（第三组，和上面空1行） from . import config from .models import User 

五、给初学者的贴心小贴士

工具辅助：用 PyCharm/VSCode 等编辑器，会自动检查 PEP8 规范（红色波浪线提醒错误）
循序渐进：先记住缩进、命名、注释这三个最基础的，再慢慢掌握其他规范
模仿学习：看优秀的 Python 代码（比如官方库、开源项目），观察别人怎么写

总结：整洁代码的核心秘密

刚开始可能会觉得麻烦，但坚持一段时间后，你会发现：写规范的代码，其实更省力！因为逻辑清晰的代码，调试和修改都更快～

现在就试试吧：打开你的编辑器，新建一个 Python 文件，按照今天学的规范写一段代码。从第一个 4 空格缩进开始，让你的代码越来越漂亮！