TypeScript 权威编码规范指南

TypeScript 权威编码规范指南，涵盖命名、类型、函数、类、模块等 18 个维度的最佳实践，生成严格模式合规的标准代码。

基本信息

• 技能名称?TypeScript
• 中文名称?TypeScript 权威编码规范指南
• 作者?wscats
• 分类?专业技能
• 版本?1.0.6
• 标签?typescript, style-guide, best-practices, coding-standards, type-safety, strict-mode, javascript

使用方法

使用说明
核心用法
该 Skill 作为 TypeScript 编码规范的完整知识库，通过自然语言自动激活。用户提及 TypeScript 相关需求时，系统自动响应并生成符合规范的代码。涵盖从基础命名约定到高级泛型、React 组件、测试规范等 18 个完整章节，提供可直接复制的代码模板和配置方案。
主要功能模块：
代码生成 ：按规范自动生成函数、类、接口、React 组件等
代码审查 ：分析现有代码并指出风格违规项
JS 转 TS ：转换代码并添加严格类型注解
项目初始化 ：提供完整的 tsconfig.json、ESLint、Prettier 配置
规范查询 ：解释任意章节的最佳实践原理
显著优点

1. 权威性来源 ：整合 Google TypeScript Style Guide、mkosir、Platypi 等业界权威规范，经社区长期验证
2. 严格模式优先 ：强制启用 "strict": true ，从源头杜绝隐式 any 和空值错误
3. 实战导向 ：提供 50+ 可直接运行的代码示例，涵盖自定义错误类、Result 模式、类型守卫等进阶模式
4. 工具链完整 ：配套 Prettier/ESLint 配置、推荐 tsconfig.json 基线、测试命名规范
5. 现代特性覆盖 ：包含 TS 5.0+ 的 satisfies 操作符、 const 类型参数等新特性用法
   潜在局限性
6. 无自动修复能力 ：作为纯文档型 Skill，无法直接操作文件系统执行格式化或重构
7. 团队适配成本 ：严格的命名约定（如无 I 前缀接口）可能与既有代码库冲突，需要团队协商
8. 版本锁定风险 ：推荐的 ES2022/NodeNext 模块配置对旧 Node 版本有兼容性要求
9. 领域特化不足 ：对特定框架（如 NestJS、Next.js）的深层模式未专门覆盖
   适合人群
   前端/全栈开发者 ：建立个人或团队的 TypeScript 编码标准
   代码审查者 ：获取客观、可引用的评审依据
   技术负责人 ：制定项目技术规范和技术选型决策
   学习者 ：系统掌握 TypeScript 类型系统的高级用法
   常规风险
   | 风险类型 | 说明 | 缓解措施 | |---------|------|---------| | 规范僵化 | 过度追求统一可能抑制合理例外 | 文档明确标注"必要时可协商调整" | | 配置误用 | 严格规则可能导致第三方库类型报错 | 配合 skipLibCheck 和 @ts-ignore 注释规范使用 | | 迁移成本 | 存量 JS 项目全面 TS 化工作量大 | 建议渐进式迁移，优先核心模块 | 该 Skill 安全等级 S+，纯文档零代码执行，适合作为团队 Code Review 的客观参照标准。