如何在WSL环境下的VSCode中启用TypeScript增量编译（tsc -w）？

核心原因 #

TypeScript的tsc -w（watch模式）依赖文件系统事件监听检测文件变更：

• 在WSL的Linux环境中，默认用inotify机制监听文件系统事件；
• 当用Windows编辑器（VSCode、记事本）修改挂载在WSL中的Windows目录（比如/mnt/c/xxx）下的文件时，Windows的文件系统事件无法被WSL的inotify正确捕获，导致tsc -w没反应；
• 用Linux编辑器（Vim等）修改WSL原生文件系统（比如~/xxx）下的文件时，inotify能直接捕获变更，所以正常触发编译。

哪怕通过VSCode的WSL连接启动tsc -w，只要项目文件在Windows挂载目录，依然会遇到跨文件系统的事件传递问题。

解决方法 #

1. 迁移项目到WSL原生文件系统 #

把TypeScript项目放在WSL的原生目录下（比如~/projects/my-ts-app），不要放在/mnt/c等Windows挂载路径。这样不管用VSCode（WSL连接）还是Linux编辑器修改文件，inotify都能正常捕获变更，tsc -w会自动触发编译。

2. 开启watch模式的轮询机制（针对必须放在Windows目录的场景） #

如果必须把项目留在Windows目录，可以修改tsconfig.json，开启轮询模式让tsc主动检查文件变化：

{
  "compilerOptions": {
    // 你的其他编译选项
  },
  "watchOptions": {
    "usePolling": true
  }
}

轮询模式会定期扫描文件状态，虽然比事件监听效率稍低，但能跨WSL和Windows文件系统生效。

3. 确保VSCode使用WSL工作区 #

打开项目时，通过VSCode的WSL扩展选择WSL环境下的项目路径，而非直接打开Windows本地文件夹，这样编辑器的文件操作会通过WSL文件系统处理，更兼容tsc -w的监听机制。

内容的提问来源于stack exchange，提问作者A. Dumais