提升Python代码可读性的核心是清晰表达意图而非炫技：使用有意义的命名、保持函数短小单一、控制参数数量、善用空行与解释性注释、添加类型提示、优先选用显式内置语法。
提升 Python 代码可读性，核心是让别人（包括未来的你）能快速理解“这段代码在做什么”和“为什么这么做”，而不是只关注“它是怎么做的”。关键不在炫技，而在清晰表达意图。
用有意义的变量和函数名
名字是代码的第一文档。避免 data、tmp、func1 这类模糊名称，直接反映其业务含义或行为目的。
-
好例子：
user_age、is_valid_email、calculate_discounted_price -
避免：
x、val、process（除非上下文极明确） - 布尔型变量/函数优先用
is_、has_、can_开头，如is_active、has_permission
保持函数短小且职责单一
一个函数最好只做一件事，并且把这件事做好。超过 20 行或嵌套超过 2 层，就该考虑拆分。
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 把重复逻辑抽成独立函数，哪怕只调用两次
- 把条件分支中的处理块提取为命名函数，例如把
if user.is_premium: send_vip_email()中的send_vip_email单独定义 - 函数参数控制在 3–4 个以内；过多时考虑用数据类或字典封装
善用空行、注释与类型提示
空白和文字不是装饰，是引导阅读节奏的标点。
立即学习“Python免费学习笔记（深入）”；
- 函数之间空两行，逻辑段之间空一行
- 注释解释 为什么，而不是 做什么（代码本身已说明“做什么”）
例如：# Retry up to 3 times to handle transient network errors比# Retry 3 times有价值得多 - 添加类型提示（
def greet(name: str) -> str:），尤其对公共函数和复杂返回值，IDE 和静态检查工具能立刻帮你发现误用
优先使用内置结构和明确语法
Python 的设计哲学之一是“显式优于隐式”。选择更直白、更贴近自然语言的写法。
- 用
for item in items:而非for i in range(len(items)):，除非真需要索引 - 用
if name in allowed_roles:而非手写循环查找 - 用列表推导式表达简单映射/过滤（
[x.upper() for x in names if x]），但别嵌套三层以上；复杂逻辑仍用普通循环更清晰 - 用
pathlib.Path处理路径，比拼接字符串或os.path更安全、可读
