playbook/docs/python/tooling.md

Python 工具链（Tooling）

本 Playbook 推荐用以下工具保证代码一致性与质量：

• black：格式化（行宽 80）
• isort：import 排序（Google profile）
• flake8：风格检查 + docstring 约定
• pylint：静态检查（以 .pylintrc 为准，可按项目调整）
• mypy：类型检查（可选）
• pytest：测试（可选）
• pre-commit：在 git commit 前自动运行上述检查/格式化（可选，但推荐）

常用命令（示例）

安装工具（示例，按项目实际依赖管理方式调整）：

python -m pip install black isort flake8 pylint mypy pytest pre-commit

格式化与检查（示例）：

black .
isort .
flake8 .
pylint .
mypy .
pytest

启用 pre-commit（只需一次）：

pre-commit install