Windows11+WSL环境下Docker-Compose卷文件修改不实时同步问题

针对你遇到的Windows本地修改文件后，Docker容器内挂载卷未实时同步的问题，可尝试以下几种解决方案：

• 将项目迁移至WSL原生文件系统
  Windows的NTFS文件系统通过/mnt挂载到WSL时，文件系统通知（inotify）支持有限，导致Docker无法实时感知文件变化。建议把项目放在WSL的家目录下（比如~/projects/your-app），而非Windows的C:\等目录。这样挂载的是WSL原生的ext4文件系统，文件同步效率和实时性会大幅提升。

• 启用WSL 2的文件通知转发
  编辑Windows用户目录下的.wslconfig文件（路径：C:\Users\<你的用户名>\.wslconfig，没有则新建），添加以下配置：

  [wsl2]
  filesystemNotifySupport = true
  kernelCommandLine = "fs.inotify.max_user_watches=524288"
  

  保存后执行wsl --shutdown重启WSL，再重新启动Docker和你的服务。

• 确认Docker Desktop的WSL集成设置
  打开Docker Desktop设置，进入Resources > WSL Integration，确保你正在使用的WSL发行版（如Ubuntu）已被勾选。应用设置后重启Docker，保证Docker能正确访问WSL的文件系统。

• 开启应用的自动重载功能
  部分开发框架默认不会自动重载文件变化，需要显式开启。比如：

  • FastAPI：启动命令添加--reload参数：uvicorn main:app --host 0.0.0.0 --port 8000 --reload
  • Django：启动命令添加--reload参数：python manage.py runserver 0.0.0.0:8000 --reload
    确保容器内的应用启动命令包含自动重载，这样文件变化后应用会自动重启加载新内容。

• 检查卷挂载路径的正确性
  在WSL终端中确认docker-compose.yml里的./app指向的是WSL内的路径，而非Windows的/mnt路径。比如如果你的项目在WSL的~/projects/your-app，那么./app就是正确的相对路径；如果还在Windows目录下，需使用WSL对应的绝对路径（如/mnt/c/Users/XXX/projects/your-app/app），但仍推荐迁移至WSL原生目录。

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