# 项目编码约定

- 使用 4 个空格缩进，不使用 Tab；遵循项目 EditorConfig 与 Prettier 配置。
- 新增或修改代码时添加适当的中文注释。公共类、服务方法和接入接口说明职责与使用前提；复杂逻辑说明设计原因、处理顺序、边界条件及异常行为。
- 配置校验、鉴权与权限、事务与幂等、第三方服务接入、日志脱敏等关键逻辑应有注释。临时占位实现要说明当前行为和后续替换位置。
- 注释保持简洁，避免逐行复述代码或给显而易见的操作添加无意义注释；修改逻辑时同步更新相关注释。