37 lines
823 B
Markdown
37 lines
823 B
Markdown
# Python 工具链（Tooling）
|
||
|
||
本 Playbook 推荐用以下工具保证代码一致性与质量：
|
||
|
||
- `black`：格式化（行宽 80）
|
||
- `isort`：import 排序（Google profile）
|
||
- `flake8`：风格检查 + docstring 约定
|
||
- `pylint`：静态检查（以 `.pylintrc` 为准，可按项目调整）
|
||
- `mypy`：类型检查（可选）
|
||
- `pytest`：测试（可选）
|
||
- `pre-commit`：在 `git commit` 前自动运行上述检查/格式化（可选，但推荐）
|
||
|
||
## 常用命令（示例）
|
||
|
||
安装工具（示例，按项目实际依赖管理方式调整）：
|
||
|
||
```bash
|
||
python -m pip install black isort flake8 pylint mypy pytest pre-commit
|
||
```
|
||
|
||
格式化与检查（示例）：
|
||
|
||
```bash
|
||
black .
|
||
isort .
|
||
flake8 .
|
||
pylint .
|
||
mypy .
|
||
pytest
|
||
```
|
||
|
||
启用 `pre-commit`（只需一次）：
|
||
|
||
```bash
|
||
pre-commit install
|
||
```
|