用途:这是一套 Python 开发模式(Python Development Patterns)指南,用于构建健壮、高效且易于维护的应用程序,适用于编写新代码、代码评审、重构以及设计包或模块时的参考。
主要能力:围绕可读性优先、显式优于隐式、EAFP(宽恕好过许可)三大原则展开。内容覆盖类型提示(基础标注、Python 3.9+ 内置泛型、TypeVar、Type Alias、基于 Protocol 的鸭子类型);错误处理(捕获特定异常、异常链 raise ... from e、自定义异常层级);上下文管理器(with、@contextmanager、类实现 enter/exit);推导式与生成器(列表推导、生成器表达式、逐行读文件);数据类与具名元组(@dataclass、field、post_init 校验、NamedTuple);装饰器(函数装饰器、参数化装饰器、基于类的装饰器,配合 functools.wraps);并发模式(ThreadPoolExecutor 用于 I/O 密集、ProcessPoolExecutor 用于 CPU 密集、asyncio 与 aiohttp);包组织(src 布局、导入顺序、init.py 导出与 all);内存与性能(slots、生成器、join 拼接字符串);以及工具链命令与 pyproject.toml 配置示例。
使用方式:把其中的惯用法与反模式清单作为编码规范应用;工具链命令可直接运行:black .、isort .、ruff check .、pylint mypackage/、mypy .、pytest --cov=mypackage --cov-report=html、bandit -r .、pip-audit、safety check。pyproject.toml 中可配置 black、ruff、mypy、pytest 等。
适用场景与限制:适合日常 Python 编码、评审、重构与项目脚手架搭建。文档示例以 Python 3.9+ 为主,部分写法(如 list[str])需 3.9+,3.8 及更早需用 typing 模块。资料未说明具体适用的框架、平台或授权方式,暂未提供;实际项目请结合自身 Python 版本与依赖情况调整。