最常踩的坑是输出路径与输入路径冲突导致无法生成js文件或报错；需在tsconfig.json中显式设outdir（如"./dist"）和rootdir（如"./src"），file watcher中手动配置arguments与output paths to refresh一致，并启用incremental与composite以提速，同时勾选监听外部配置变更。
File Watcher 配置里最常踩的坑：输出路径和输入路径打架
改完 .ts 文件保存后没生成 .js，或者报错 Cannot write file because it would overwrite input file，基本就是这个原因。TypeScript 默认不设 outDir，编译器会尝试把 .js 写回原目录，和源文件撞在一起。
必须在 tsconfig.json 里显式声明输出位置：
-
"outDir": "./dist"（不能是"./src"或"."） - 确保
dist目录不在src下，否则 File Watcher 可能二次触发、无限循环 - 同时配好
"rootDir": "./src"，避免 tsc 把无关.ts文件也纳入编译范围
File Watcher 的 Arguments 和 Output paths to refresh 必须对齐
WebStorm/PhpStorm 的 File Watcher 不会自动读取 tsconfig.json 里的 outDir，你得手动告诉它“生成了什么、去哪找”。光写 --project tsconfig.json 不够。
推荐配置（Settings → Tools → File Watchers → + → TypeScript）：
-
Program：填
tsc（确保已全局安装或项目内有node_modules/.bin/tsc） -
Arguments：
--project $ProjectFileDir$/tsconfig.json --noEmit false --skipLibCheck true -
Output paths to refresh：
$ProjectFileDir$/dist/$FileNameWithoutExtension$.js,$ProjectFileDir$/dist/$FileNameWithoutExtension$.js.map -
Working directory：必须是项目根目录，即
$ProjectFileDir$（里面得有tsconfig.json）
增量编译（incremental）不是默认开启的
每次保存都全量编译整个项目，大一点的代码库会卡顿明显。启用增量编译能显著提速，但需要两个条件同时满足：
Galileo TypeScript sdk
下载
完整的Galileo AI平台 TypeScript/JS SDK 参考，用于评估、观察和保护 GenAI 应用。适用于构建 Node.js 或 TypeScript 项目。
-
tsconfig.json中加"incremental": true - 同时加
"composite": true（哪怕你只有一个项目，也得加；这是 TypeScript 的硬性要求） - 注意：
composite: true会生成.tsbuildinfo文件，别把它提交进 Git
如果只开 incremental 不加 composite，tsc 会静默忽略该配置，毫无效果。
为什么改了 tsconfig.json 后编译没反应？
File Watcher 默认只监听 .ts 文件变更，不监听配置文件。这意味着你调了 outDir、加了 paths，甚至删了 exclude，都不会触发重新编译。
解决办法很简单，在 File Watcher 设置里勾上：
-
Trigger the watcher on external changes（让 Watcher 响应
tsconfig.json修改） - Auto-save edited files to trigger the watcher（避免因编辑器未自动保存导致漏触发）
这两个勾不打，等于白配——尤其是团队协作时别人改了配置，你本地却一直用旧规则跑。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
