用途:这是一份 JavaScript 与 TypeScript 编码规范与最佳实践指南,目标是在团队与项目中写出一致、易读、易维护、可表达的代码,强调清晰优于机巧、简单优于复杂、代码应像散文一样自然。
主要能力:内容按主题组织,涵盖语言最佳实践(使用现代语法、默认用 const 与 let、采用有意义的命名)、TypeScript 实践(优先类型推断、用可辨识联合建模状态、保持类型简单)、函数模式(函数小而专注、使用提前返回的守卫子句、统一用 async/await)、对象与数组模式(解构、filter/map/reduce/some 等函数式方法)、错误处理(异步 try-catch、自定义错误类)、代码组织(按功能而非按类型分组、模式出现后再抽取复用逻辑)、注释(代码自解释、注释解释为什么而非是什么)、测试(测试可读、测行为而非实现),并列出需避免的反模式(回调地狱、到处可变、上帝对象)。
使用方式:作为编码时参考的规范来阅读与遵循;资料以正误示例对比的方式呈现,涉及解构、展开运算符、可选链、空值合并、模板字符串、Object 方法、Pick 等写法。资料未提供安装命令、命令行工具或其他集成方式,暂未提供。
适用场景:适合 JavaScript/TypeScript 项目的日常开发、代码评审与规范统一,也可供个人学习表达性写法。
限制:资料为理念与示例型实践,不针对特定框架、运行时或工具链给出强制配置,也未提供自动检查、规则引擎或版本兼容性说明,相关资料暂未提供。