JavaScript 项目可渐进式接入 TypeScript，无需重写代码，只需配置 tsconfig.json 并启用 "checkJs": true 即可对 JS 文件进行类型检查。
JavaScript 项目可以渐进式接入 TypeScript，不需要重写代码，核心在于配置 tsconfig.json 和使用 tsc --noEmit 做类型检查即可。
如何在现有 JS 项目中启用 TS 类型检查
不需要把 .js 文件改成 .ts，只需添加 jsconfig.json（VS Code）或 tsconfig.json（tsc / IDE），并开启 "checkJs": true：
{
"compilerOptions": {
"checkJs": true,
"allowJs": true,
"skipLibCheck": true,
"strict": false
},
"include": ["**/*.js"]
}-
checkJs是关键开关，让 TypeScript 检查 JS 文件中的 JSDoc 类型注释 -
allowJs允许编译器读取 JS 文件（即使不生成输出） -
strict建议先设为false，避免大量报错打断开发节奏 - JSDoc 注释如
/** @type {string[]} */或/** @param {number} id */会被识别为类型信息
TS 类型系统真正起作用的场景
类型不是为了“写更多代码”，而是在几个关键位置降低出错概率：
- 函数入参和返回值：比如
fetchUser(id)明确要求id是string，调用时传undefined会立刻标红 - 对象结构约定：
/** @type {{ name: string; age?: number }} */能约束解构、赋值、新增字段等行为 - 第三方库调用：配合
@types/react等包，useState()的泛型推导、事件对象的event.target.value类型都能被识别 - 重构安全：重命名一个函数名后，所有调用处若类型不匹配，编辑器会高亮未更新的调用点
常见误用与性能陷阱
过度依赖类型反而拖慢开发，尤其在动态逻辑多的项目里：
立即学习“Java免费学习笔记（深入）”；
- 不要给每个变量都加
/** @type {...} */—— 只在接口边界（函数签名、模块导出、配置对象）加 - 避免嵌套过深的类型，例如
Record<string array items: record value: unknown> }></string>，可读性差且推导慢 -
any不是禁词，但unknown更安全；用as const替代手动写字面量联合类型（如'loading' | 'success' | 'error'） - 大型项目开启
"incremental": true和"composite": true，否则tsc --watch启动慢、内存占用高
最常被忽略的是：类型检查本身不运行，它只在编辑器或构建阶段介入。这意味着即便类型全绿，运行时仍可能因 JSON.parse、用户输入、API 返回结构变更而出错 —— 类型系统是手电筒，不是防火墙。
