TypeScript性能优化指南：45条最佳实践规则，提升编译速度与类型安全

typescript by pproenca/dot-skills

660 周安装量

86 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/pproenca/dot-skills --skill typescript

开发 JavaScript 框架性能优化

🇨🇳中文介绍

TypeScript 最佳实践

TypeScript 应用程序的全面性能优化指南。包含 8 个类别共 45 条规则，按影响优先级排序，以指导自动化重构和代码生成。

何时应用

在以下情况下参考这些指南：

为新项目或现有项目配置 tsconfig.json 时
编写复杂的类型定义或泛型时
优化 async/await 模式和数据获取时
组织模块和管理导入时
审查代码的编译或运行时性能时

按优先级划分的规则类别

优先级	类别	影响	前缀
1	类型系统性能	关键	`type-`
2	编译器配置	关键	`tscfg-`
3	异步模式	高

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

🇺🇸English

TypeScript Best Practices

Comprehensive performance optimization guide for TypeScript applications. Contains 45 rules across 8 categories, prioritized by impact to guide automated refactoring and code generation.

When to Apply

Reference these guidelines when:

Configuring tsconfig.json for a new or existing project
Writing complex type definitions or generics
Optimizing async/await patterns and data fetching
Organizing modules and managing imports
Reviewing code for compilation or runtime performance

Rule Categories by Priority

Priority	Category	Impact	Prefix
1	Type System Performance	CRITICAL	`type-`
2	Compiler Configuration	CRITICAL	`tscfg-`
3	Async Patterns	HIGH	`async-`
4	Module Organization	HIGH	`module-`
5	Type Safety Patterns	MEDIUM-HIGH	`safety-`
6	Memory Management	MEDIUM	`mem-`
7	Runtime Optimization	LOW-MEDIUM	`runtime-`
8	Advanced Patterns	LOW	`advanced-`

Type System Performance — CRITICAL
- 1.1 Add Explicit Return Types to Exported Functions — CRITICAL (30-50% faster declaration emit)
- 1.2 Avoid Deeply Nested Generic Types — CRITICAL (prevents exponential instantiation cost)
- 1.3 Avoid Large Union Types — CRITICAL (quadratic O(n²) comparison cost)
- 1.4 Extract Conditional Types to Named Aliases — CRITICAL (enables compiler caching, prevents re-evaluation)
- 1.5 Limit Type Recursion Depth — HIGH (prevents exponential type expansion when applicable)
- 1.6 Prefer Interfaces Over Type Intersections — CRITICAL (2-5× faster type resolution)
- 1.7 Simplify Complex Mapped Types — HIGH (reduces type computation by 50-80% when applicable)
Compiler Configuration — CRITICAL

References

Weekly Installs

643

Repository

pproenca/dot-skills

GitHub Stars

First Seen

Jan 20, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

opencode437

claude-code426

gemini-cli398

codex394

cursor371

github-copilot370

2.1 Configure Include and Exclude Properly — CRITICAL (prevents scanning thousands of unnecessary files)
2.2 Enable Incremental Compilation — CRITICAL (50-90% faster rebuilds)
2.3 Enable isolatedDeclarations for Parallel Declaration Emit — CRITICAL (enables parallel .d.ts generation without type-checker)
2.4 Enable skipLibCheck for Faster Builds — CRITICAL (20-40% faster compilation)
2.5 Enable strictFunctionTypes for Faster Variance Checks — CRITICAL (enables optimized variance checking)
2.6 Use erasableSyntaxOnly for Node.js Native TypeScript — HIGH (prevents 100% of Node.js type-stripping runtime errors)
2.7 Use isolatedModules for Single-File Transpilation — CRITICAL (80-90% faster transpilation with bundlers)
2.8 Use Project References for Large Codebases — CRITICAL (60-80% faster incremental builds)

Async Patterns — HIGH

3.1 Annotate Async Function Return Types — HIGH (prevents runtime errors, improves inference)
3.2 Avoid await Inside Loops — HIGH (N× faster for N iterations, 10 users = 10× improvement)
3.3 Avoid Unnecessary async/await — HIGH (eliminates trivial Promise wrappers and improves stack traces)
3.4 Defer await Until Value Is Needed — HIGH (enables implicit parallelization)
3.5 Use Promise.all for Independent Operations — HIGH (2-10× improvement in I/O-bound code)

Module Organization — HIGH

4.1 Avoid Barrel File Imports — HIGH (200-800ms import cost, 30-50% larger bundles)
4.2 Avoid Circular Dependencies — HIGH (prevents runtime undefined errors and slow compilation)
4.3 Control @types Package Inclusion — HIGH (prevents type conflicts and reduces memory usage)
4.4 Use Dynamic Imports for Large Modules — HIGH (reduces initial bundle by 30-70%)
4.5 Use Type-Only Imports for Types — HIGH (eliminates runtime imports for type information)

Type Safety Patterns — MEDIUM-HIGH

5.1 Enable noUncheckedIndexedAccess — MEDIUM-HIGH (prevents 100% of unchecked index access errors at compile time)
5.2 Enable strictNullChecks — MEDIUM-HIGH (prevents null/undefined runtime errors)
5.3 Prefer unknown Over any — MEDIUM-HIGH (forces type narrowing, prevents runtime errors)
5.4 Use Assertion Functions for Validation — MEDIUM-HIGH (reduces validation boilerplate by 50-70%)
5.5 Use const Assertions for Literal Types — MEDIUM-HIGH (preserves literal types, enables better inference)
5.6 Use Exhaustive Checks for Union Types — MEDIUM-HIGH (prevents 100% of missing case errors at compile time)
5.7 Use Type Guards for Runtime Type Checking — MEDIUM-HIGH (eliminates type assertions, catches errors at boundaries)

Runtime Optimization — LOW-MEDIUM

7.1 Avoid Object Spread in Hot Loops — LOW-MEDIUM (reduces object allocations by N×)
7.2 Cache Property Access in Loops — LOW-MEDIUM (reduces property lookups by N× in hot paths)
7.3 Prefer Native Array Methods Over Lodash — LOW-MEDIUM (eliminates library overhead, enables tree-shaking)
7.4 Use for-of for Simple Iteration — LOW-MEDIUM (reduces iteration boilerplate by 30-50%)
7.5 Use Modern String Methods — LOW-MEDIUM (2-5× faster than regex for simple patterns)
7.6 Use Set/Map for O(1) Lookups — LOW-MEDIUM (O(n) to O(1) per lookup)