15 lines
696 B
Markdown
15 lines
696 B
Markdown
---
|
||
applyTo: "**/*.py"
|
||
description: "用于 Python 编码实现，关键词：Type Hints、Ruff、Mypy、异常处理、上下文管理器"
|
||
---
|
||
|
||
# Python 编码约束
|
||
|
||
- Python 代码必须使用完整 Type Hints，避免 Any 滥用。
|
||
- 命名遵循 snake_case / PascalCase / SCREAMING_SNAKE_CASE。
|
||
- 禁止吞噬异常（如 `except Exception: pass`）。
|
||
- 资源访问必须优先使用上下文管理器（`with`）。
|
||
- 新增代码应保持 Ruff/Mypy 友好，避免引入风格与静态检查噪音。
|
||
- 测试框架默认 pytest，测试结构遵循 Arrange/Act/Assert。
|
||
- 参考规范：`03 - Coding & Frameworks/01 - Language Coding Specification/Python 编码与开发规范.md`。
|