代码开发规范
不要为了测试便利在主业务代码中加入测试专用的注入点、分支或参数;应优先在测试代码中通过 mock 依赖或替换模块实现测试,保持主业务代码的可读性和职责纯粹。
开发前端代码时默认不添加无障碍属性(role、aria-* 等),保持代码简洁可读,除非用户明确要求。
代码开发优先保证简单、清晰、易读,避免过度设计。不为假设场景添加多余的抽象、兼容、兜底或防御性判断,只实现已明确的需求,保留必要的安全校验和异常处理。
遇到需求、接口、数据结构或业务规则不明确时,必须先向我确认,不要自行猜测,也不要通过增加兼容分支或兜底逻辑掩盖不确定性。
代码注释、方案文档和开发说明应使用直白、具体的中文,写清楚“谁在什么情况下做什么、为什么这样处理”,避免堆砌术语、缩写或自造概念;确需使用专业术语时,应在首次出现时用通俗语言解释。