python-best-practices

用途：这是一套 Python 编码规范与示例集合，帮助开发者写出类型安全、可维护、符合现代 Python 习惯的代码。主要能力：类型提示使用 3.9+ 内置泛型（list[str]）、3.10+ 的 | 联合类型、3.12+ 的 type 参数语法与 TypedDict；建议在 CI 中使用 mypy --strict 或 pyright，谨慎使用 type: ignore。数据建模区分场景：dataclasses 用于内部领域模型与无需校验的结构（可用 frozen=True、slots=True），Pydantic 用于 API 边界、配置文件与外部数据解析（Field 约束、field_validator）。异步部分推荐用 httpx 替代 requests，用 asyncio.gather 并发、asyncio.Semaphore 限流，用 async with 管理资源，禁止在异步函数中做阻塞 I/O（旧代码可用 asyncio.to_thread）。工程实践给出 src 布局、pyproject.toml 配置（hatchling 构建、可选依赖、project.scripts、Ruff、mypy、pytest 配置），推荐用 Ruff 替代 flake8+isort+black。虚拟环境建议使用 uv venv 或 python -m venv .venv，并用锁文件固定版本，不全局安装包。测试部分基于 pytest，使用 conftest.py 共享 fixture、pytest.mark.parametrize 参数化、tmp_path 做文件测试，异步测试配 pytest-asyncio。此外还汇总了解包、推导式、上下文管理器、海象运算符、结构模式匹配等惯用法，以及自定义异常层级与避免裸 except 的异常处理规则。适用场景：Python 项目初始化、代码评审规范、CI 质量门禁搭建。限制：原文未提供作者、许可、安装方式或收录来源等信息，也未说明适用版本之外的工具链细节，相关内容暂未提供。