TS编译失败但无报错，主因是tsconfig.json中noEmit为true或outDir配置不当；需设noEmit为false、确保outDir存在且非源码目录，并验证include规则与tsc命令执行效果。
TS 编译失败但没报错？检查 tsconfig.json 的 noEmit 和 outDir
VSCode 本身不编译 TypeScript，它只靠 TypeScript 语言服务做语法检查和智能提示。真正编译靠的是 tsc 命令，而它的行为完全由 tsconfig.json 控制。
常见现象：改了 .ts 文件，但生成的 .js 文件没更新，或者根本没生成 —— 很可能 noEmit 被设为 true（这是 VSCode 初始化时的默认值），或者 outDir 指向了不存在的路径、或被 include/exclude 规则意外排除。
-
noEmit必须设为false才会输出 JS 文件 -
outDir路径必须存在，且不能是源码目录（否则可能循环写入） - 确认
include包含了你的 .ts 文件，比如["src/**/*"]；如果用了files，漏写文件就直接不参与编译 - 用命令行跑
tsc --build或tsc -p tsconfig.json验证配置是否生效，别只依赖 VSCode 的保存自动编译（它默认不开启）
VSCode 里改了代码却看不到类型错误？重启 TS 服务或检查 typescript.tsdk
VSCode 内置的 TS 语言服务版本可能和你项目本地安装的不一致，导致类型检查“失灵”：比如用了新语法（const 断言、 satisfies），但内置 TS 版本太老，直接忽略报错。
解决方法不是升级 VSCode，而是告诉它用项目里的 TS：
- 在工作区设置里加：
"typescript.tsdk": "./node_modules/typescript/lib" - 确保项目已执行
npm install typescript --save-dev - 改完设置后，按
Ctrl+Shift+P（Win）或Cmd+Shift+P（Mac），输入 “TypeScript: Restart TS server” 手动重启服务 - 检查状态栏右下角的 TS 版本号，它应该显示类似 “Version 5.3.3 (local)” 而不是 “Bundled”
调试时报错 “Cannot launch program … because corresponding JavaScript cannot be found”？配对 sourceMap 和 outFiles
这个错误本质是 VSCode 的 Debugger 找不到生成的 JS 文件来映射源码。TypeScript 编译本身没问题，但调试器没被正确引导。
关键不在 launch.json 本身，而在 tsconfig.json 和调试配置的配合：
-
tsconfig.json中必须有："sourceMap": true，且"outDir"和"rootDir"设置合理（比如rootDir: "src",outDir: "dist"） -
launch.json的program字段要指向编译后的 JS 入口，比如"program": "${workspaceFolder}/dist/index.js" - 如果入口是 ES 模块（
type: "module"），需加"runtimeArgs": ["--enable-source-maps"]，Node.js 12+ 才支持 - 不要用
preLaunchTask启动tsc --watch，它和 VSCode 自带的构建任务容易冲突；改用npm run build作为 task 更稳
为什么保存后没自动编译？启用 compilerOptions.watch 不是 VSCode 的事
VSCode 没有“保存即编译”这个功能开关。所谓自动编译，其实是靠外部进程（如 tsc --watch）监听文件变化并触发编译，VSCode 只负责把终端输出染色、跳转错误行。
想实现保存即看到 JS 更新，得手动启动监听：
- 在终端运行
npx tsc --watch（推荐加--onFailure "echo compile failed"避免静默失败） - 或配一个
tasks.json任务，类型设为shell，命令为tsc --watch，并设"isBackground": true和匹配的problemMatcher - 注意：
tsc --watch在 WSL 或某些 Docker 环境下可能监听失效，此时换用nodemon --ext ts --exec tsc更可靠 - 别指望 VSCode 设置里勾个选项就能替代这些 —— 它的设计哲学就是“不接管构建流程”，只做好编辑器本职
最易被忽略的一点：tsconfig.json 里如果写了 "composite": true，那 tsc --watch 就必须搭配 --build 使用，否则连监听都不会启动。这时候错误信息极其安静，只会卡住不动。
