Python 常用语法与代码组织

这篇文档只覆盖日常开发中最常用的 Python 写法，重点是写出清晰、可维护的代码。

基本数据结构#

1
name = "alice"
2
age = 20
3
scores = [88, 91, 95]
4
profile = {"name": name, "age": age}
5
unique_tags = {"python", "backend"}

列表适合有顺序的数据，字典适合键值映射，集合适合去重和成员判断，元组适合表达不应随意修改的固定组合。

条件与循环#

1
for score in scores:
2
    if score >= 90:
3
        print("优秀", score)
4
    elif score >= 60:
5
        print("合格", score)
6
    else:
7
        print("需要改进", score)

需要索引时使用 enumerate()：

1
for index, score in enumerate(scores, start=1):
2
    print(index, score)

同时遍历两组数据时使用 zip()，不要手工维护多个下标。

函数与类型提示#

1
def average(values: list[float]) -> float:
2
    if not values:
3
        raise ValueError("values 不能为空")
4
    return sum(values) / len(values)

类型提示不会自动限制运行时数据，但能帮助编辑器、静态检查工具和读代码的人理解接口。

参数较多时优先使用关键字参数：

1
def connect(host: str, port: int = 5432, *, timeout: float = 5.0) -> None:
2
    print(host, port, timeout)
3

4

5
connect("127.0.0.1", timeout=2.5)

* 后的参数必须显式写参数名，可以减少调用顺序错误。

推导式#

1
passed = [score for score in scores if score >= 60]
2
score_map = {index: score for index, score in enumerate(scores, start=1)}

推导式适合一层简单转换。逻辑过长、包含多个分支时，普通循环通常更清晰。

异常处理#

1
from pathlib import Path
2

3

4
def read_config(path: Path) -> str:
5
    try:
6
        return path.read_text(encoding="utf-8")
7
    except FileNotFoundError as error:
8
        raise RuntimeError(f"配置文件不存在：{path}") from error

只捕获你能处理的异常。避免使用裸 except:，它会把程序退出、键盘中断等信号也吞掉。

上下文管理器#

1
from pathlib import Path
2

3
with Path("data.txt").open("w", encoding="utf-8") as file:
4
    file.write("hello\n")

with 能保证文件、锁和连接在异常情况下也被正确释放。

模块组织#

1
my_project/
2
├── pyproject.toml
3
├── src/
4
│   └── my_app/
5
│       ├── __init__.py
6
│       ├── config.py
7
│       └── main.py
8
└── tests/

避免把所有逻辑写进一个脚本。按职责拆分模块，并把程序入口放在 main() 中。

实用原则#

变量名表达含义，不使用无意义缩写。
函数尽量只承担一个职责。
优先返回结果，不在底层函数里到处打印。
对外接口写类型提示和简短文档字符串。
先写可读代码，再考虑微小性能优化。

开发动态