webstorm typescript 自动编译需同时满足三条件：tsc 已安装并被正确识别、tsconfig.json 配置合法且 outdir 等关键选项正确、file watcher 手动配置为基于 tsconfig.json 的监听；任一缺失都将导致 .js 文件不生成。
tsc 必须装好、tsconfig.json 必须配对、File Watcher 必须用对——缺一不可。WebStorm 自带的 TypeScript Language Service 只做类型检查，不生成 JS；所谓“自动编译”，本质是靠 File Watcher 调用本地 tsc 实现的。
确认 tsc 已安装且 WebStorm 能定位到它
WebStorm 默认不认全局安装的 typescript，哪怕终端里 tsc --version 能跑通，IDE 仍可能报 Cannot find TypeScript compiler。
- 执行
npm install typescript --save-dev，确保node_modules/typescript存在 - 进 Settings → Languages & Frameworks → TypeScript，TypeScript version 下拉菜单里手动选
Project preferences → node_modules/typescript/lib/tsc.js - 如果下拉为空，先点右侧刷新按钮；再不行，终端进项目根目录运行
ls node_modules/typescript/lib/tsc.js确认路径和权限
用 tsconfig.json 控制输出行为，不是靠 IDE 设置
WebStorm 的 Settings → Languages & Frameworks → TypeScript 里勾选 “Recompile on changes” 是无效的——它只影响语言服务，不触发 JS 生成。真正决定是否出 JS、出在哪、带不带 source map 的，全是 tsconfig.json 里的 compilerOptions。
-
"outDir": "./dist"必须显式设置，且路径不能和源码目录重叠（比如别设成"./src"或"."，否则报Cannot write file because it would overwrite input file） -
"noEmit"必须为false（默认值，但有人误改成true就静默失败） -
"emitDeclarationOnly"如果为true，只生成.d.ts，JS 文件完全不会更新——这个开关特别隐蔽 - 需要 source map 就加
"sourceMap": true，不然调试时无法映射回 TS 行号
File Watcher 配置必须匹配项目结构
选错模板、路径写错、开关没开，都会导致保存后 JS 文件不出现。最稳妥的方式是手动建一个基于 tsconfig.json 的 watcher，而不是选 “TypeScript” 模板。
- Settings → Tools → File Watchers → + →
tsconfig.json（注意：不是 “TypeScript”） - Working directory 设为
$ProjectFileDir$（即tsconfig.json所在目录） - Arguments 填：
--project $ProjectFileDir$/tsconfig.json --noEmit false --skipLibCheck true - Output paths to refresh 填：
$ProjectFileDir$/dist/$FileNameWithoutExtension$.js（如果outDir是./build，就对应改成build） - 务必勾选：
Auto-save edited files to trigger the watcher和Trigger the watcher on external changes（后者常被忽略，导致 Git 切分支或 Prettier 格式化后不编译）
常见错误现象和对应检查点
改完 .ts 保存，.js 没生成？大概率是下面某一项没对上。
- 控制台报
Cannot find tsc→ 检查node_modules/typescript是否存在，以及 Settings 里 TypeScript version 是否手动指向了lib/tsc.js - 报
Cannot write file because it would overwrite input file→tsconfig.json缺outDir，或outDir设成了"."/"./src" - TS 不报错，但 JS 文件始终不更新 → 检查
"noEmit"和"emitDeclarationOnly"是否被意外开启 - 第一次能生成，改第二次就没反应 →
Trigger on external changes没勾，或者Output paths to refresh留空，WebStorm 不知道该刷新哪个文件
tsc CLI、File Watcher 这三层各管一摊，又必须严丝合缝地对齐路径、配置、开关状态。任何一个环节松动，保存动作就只停留在编辑器里，走不到磁盘上的 .js 文件。
