ci中black需用--check模式校验而非修改，配合--diff和统一line-length；flake8须忽略与black冲突规则；推荐合并为单命令或用tox统一管理，并确保python版本、工具版本、配置文件及换行符环境一致。
CI里怎么让Black自动格式化并拒绝不合规代码
Black必须在CI中以--check模式运行，否则它只会“悄悄改文件”而不会阻断流水线。本地开发时用black .没问题，但CI里得强制校验而非修改。
- 推荐命令：
black --check --diff --line-length=88 .，其中--diff能让失败时输出具体差异，方便快速定位 - 注意
--line-length要和团队配置一致，否则本地pass、CI fail——常见坑是本地没配pyproject.toml或用了不同值 - 如果项目含notebook（.ipynb），需额外加
--skip-string-normalization或配合nb-black，否则会因JSON字段顺序报错
Flake8怎么避免“警告当错误”的误判
Flake8默认把E（error）和W（warning）都当错误，但有些W类（如W503行续行位置）已被PEP8弃用，Black又强制用W504，直接跑flake8 .大概率冲突。
Python Sdk
下载
inference.sh 的 Python SDK：运行 AI 应用、构建智能体，并集成 150 多个模型。包名：inferencesh (pip install inferencesh)。支持同步/异步……
- 必须禁用与Black冲突的规则：
flake8 --select=E,W,F --ignore=E203,W503,W504 . - 更稳妥的做法是用
pyproject.toml统一管理：[tool.flake8] select = ["E", "F", "W"] ignore = ["E203", "W503", "W504"] max-line-length = 88
- 别漏掉
--extend-ignore参数——如果已有.flake8配置，CI命令里用--extend-ignore比--ignore更安全，避免覆盖全局忽略项
怎么把Black和Flake8串成一个原子检查步骤
分开跑两个命令看似清晰，但CI里多一个步骤就多一次缓存失效、环境重载开销，且失败信息分散。建议合并为单条命令，靠返回码控制流程。
- Shell写法（GitHub Actions / GitLab CI通用）：
black --check --line-length=88 . && flake8 .
，利用&&短路特性：Black失败则Flake8根本不执行 - 想看完整报告？改用
bash -c 'black --check --diff .; black_exit=$?; flake8 .; flake8_exit=$?; exit $((black_exit || flake8_exit))' - Python项目若用
tox，直接在tox.ini里定义lint环境，依赖black和flake8，CI里只跑tox -e lint，可复用、易调试
为什么CI里总遇到“本地能过、CI报错”的问题
根本原因不是工具本身，而是环境不一致：Python版本、Black/Flake8小版本、配置文件加载路径、甚至Git换行符处理都会导致行为偏差。
- Black 22.3.0+ 默认启用
--preview实验特性，旧版CI镜像可能没升级，结果格式化规则不一致——务必在pyproject.toml里显式写preview = false - Flake8从3.x升到4.x后，
--max-line-length参数被废弃，改用--extend-max-line-length或配置文件，CI脚本没同步就会静默失效 - 最隐蔽的坑：
git clone时Windows默认启用core.autocrlf=true，导致LF/CRLF混用，Black认为文件“已修改”，--check直接失败——CI里加git config --global core.autocrlf input保平安
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
