WSL2中开发工具无法监听文件变更怎么办？

核心原因 #

WSL2与Windows系统采用独立的文件系统，当你在Windows侧修改存储于Windows挂载目录（如/mnt/c、/mnt/d等）的文件时，WSL2内核无法实时捕获文件系统的变更事件（inotify事件）——而绝大多数开发工具依赖inotify监听文件改动，这直接导致工具无法触发自动重建/更新。此外，部分工具的默认监听配置未适配WSL2的文件系统特性，也会引发该问题。

通用解决方案 #

1. 将项目移至WSL2内部文件系统 #

把代码放在WSL2原生目录（如~/projects）而非Windows挂载目录。WSL2对自身文件系统的文件变更监听支持完善，能正常触发工具的自动更新逻辑。

2. 启用WSL2文件变更通知转发（Windows 11 22H2及以上版本适用） #

Windows 11 22H2更新后，WSL2支持自动转发Windows文件系统的变更通知到Linux侧，操作步骤如下：

• 打开PowerShell执行更新命令：

  wsl --update
  

• 在WSL终端创建或编辑/etc/wsl.conf文件：

  sudo nano /etc/wsl.conf
  

  添加以下配置：

  [automount]
  options = "metadata,umask=0022,fmask=0133"
  [interop]
  enabled = true
  appendWindowsPath = true
  [wsl2]
  notify-send = true
  

  保存后关闭WSL终端，在PowerShell中执行wsl --shutdown重启WSL，再重新启动开发工具。

3. 强制工具使用轮询模式监听 #

若无法移动项目或启用通知转发，可修改工具配置，让工具以轮询方式检查文件变化（轮询不依赖inotify）。不同工具的配置方式示例：

• nodemon：启动时添加--legacy-watch参数
• webpack：在配置文件中设置watchOptions.poll = true
• Flask：启动时添加--reload --extra-files .参数

注意：Stack Overflow上存在多个根源相同但针对不同开发工具的相关问题，本文是面向所有工具的通用问答（社区维基版）。部分工具可能还有特定解决方案，可参考以下工具专属问题：

• nodemon：如何让nodemon在WSL 2中正常工作？
• npm run watch：npm watch在WSL中突然停止工作
• Tailwind：Tailwind在WSL2上热重载无法正常工作
• tail -f：如何在WSL-2中查看不断增长的文件末尾内容？
• webpack --watch：在Windows的Ubuntu Bash中运行webpack --watch只构建一次就退出
• Angular LiveReload：Angular LiveReload无法在Windows Subsystem for Linux中工作
• React：WSL 2中React无法随文件变更自动重载？
• Flask：在WSL下运行时Flask无法重载修改后的代码
• Next.js：必须重启Next.js开发服务器才能查看变更
• Parcel热模块重载（HMR）：Parcel、Webpack 5的HMR在WSL2/Ubuntu 22.04中无法工作
• Django：Django服务器启用重载后忽略文件变更

内容的提问来源于stack exchange，提问作者NotTheDr01ds