python.md 665 B

Python 约束

本文件为公司统一配置(L1)的语言约束部分。 按需动态加载:当任务涉及 Python 代码编写时加载本文件。


一、风格要求

  1. 遵循 PEP 8:使用 ruff 或 black 格式化
  2. 类型注解:函数签名必须有类型提示(Python >= 3.10 支持 X | None 语法)
  3. 路径处理:使用 pathlib.Path,禁止字符串拼接路径
  4. 脚本入口if __name__ == '__main__': 保护
  5. 依赖管理:必须在 requirements.txt / pyproject.toml 中声明,禁止 pip install xxx 不记录

最后更新:2026-04-18 版本:4.0.0(3层架构版)