Windows11环境下Docker部署React应用无法检测本地文件变更问题

问题核心诱因 #

Windows系统与Docker容器之间的文件系统变更通知无法默认透传，且Create React App（CRA）依赖的文件监听工具默认未开启适配Windows挂载卷的轮询模式。

解决方案 #

按优先级依次尝试以下操作即可：

• 启动容器时新增监听轮询环境变量
  CRA内置的chokidar、watchpack监听工具开启轮询模式后可兼容Windows挂载卷的变更检测，直接在run命令中添加参数即可，修改后完整命令为：

  docker run -it -p 3000:3000 -v /app/node_modules -v ${PWD}:/app -e CHOKIDAR_USEPOLLING=true -e WATCHPACK_POLLING=true dawnmd/react
  

  也可以直接将配置写入Dockerfile.dev，在CMD指令前新增一行：

  ENV CHOKIDAR_USEPOLLING=true WATCHPACK_POLLING=true
  

• 检查Docker Desktop文件共享权限
  打开Docker Desktop设置 → 资源 → 文件共享，确认项目所在的磁盘（如C盘、D盘）已勾选开启共享，否则挂载卷无法读取本地文件变更。
• 调整项目存储位置（WSL2后端用户适用）
  如果你使用WSL2作为Docker的运行后端，不要将项目存放在Windows原生的磁盘挂载路径（如/mnt/c/）下，将项目迁移到WSL原生文件系统的用户目录（如/home/你的用户名/）下再启动容器，可同时解决监听失效和性能低下的问题。
• 验证react-scripts版本兼容性
  若使用低于3.4.0版本的react-scripts，可升级到最新稳定版，旧版本存在Windows挂载卷监听的已知bug。

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