Visual Studio 2022 .NET6 Docker环境下Hot Reload功能失效

问题复现特征 #

• 为.NET 6、ASP.NET Core 6 MVC项目通过Visual Studio Container Tools添加Docker（Linux容器）支持后，Hot Reload（热重载）、*Edit and Continue（编辑并继续）*功能完全失效
• 同一项目切换到Kestrel、IIS Express运行时，修改控制器、Razor视图代码保存后变更即时生效；Docker容器模式下必须重启应用才能加载修改内容
• 使用VS内置模板创建全新MVC项目并添加Docker支持后问题复现，排除项目自定义配置干扰，官方文档未标注该场景下功能不受支持

修复步骤 #

1. 前置环境校验 #

• 将Visual Studio 2022升级到17.4及以上版本，17.4之前版本的Container Tools未适配Linux容器场景下的热重载通信逻辑
• 打开菜单路径 调试 > 选项 > 容器工具，确认勾选启动容器后快速重载、调试时启用文件卷映射，取消勾选启动时拉取最新基础镜像避免镜像版本与工具版本不匹配
• 检查项目根目录Dockerfile，调试阶段基础镜像必须使用带SDK、调试组件的mcr.microsoft.com/dotnet/sdk:6.0，不能使用runtime或runtime-deps镜像；确认Dockerfile中未手动将DOTNET_USE_POLLING_FILE_WATCHER设为false

2. 调整启动配置 #

• 打开项目Properties/launchSettings.json，找到Docker配置节点，补充热重载相关环境变量：

"Docker": {
  "commandName": "Docker",
  "launchBrowser": true,
  "launchUrl": "{Scheme}://{ServiceHost}:{ServicePort}",
  "environmentVariables": {
    "ASPNETCORE_ENVIRONMENT": "Development",
    "DOTNET_USE_POLLING_FILE_WATCHER": "true",
    "DOTNET_WATCH_RESTART_ON_RUDE_EDIT": "true"
  },
  "publishAllPorts": true,
  "useSSL": true
}

• 右键项目选择添加 > 容器编排支持 > Docker Compose，在自动生成的docker-compose.override.yml中确认源码卷映射配置，缺失则手动补充，确保本地源码目录正确挂载到容器内工作目录：

version: '3.4'
services:
  [你的项目服务名]:
    environment:
      - ASPNETCORE_ENVIRONMENT=Development
      - DOTNET_USE_POLLING_FILE_WATCHER=true
    volumes:
      - ~/.vsdbg:/remote_debugger:rw
      - ./[你的项目根目录名]:/src
    working_dir: /src

卷映射是热重载生效的核心：没有该配置时容器内运行的是预编译的dll文件，无法感知本地源码的修改。

3. 调试选项配置 #

• 点击VS顶部工具栏的热重载图标下拉菜单，勾选调试时启用热重载、保存文件时应用热重载两个选项
• 首次启动容器后，将输出窗口的日志源切换为容器工具，确认日志中出现文件监视启动、源目录映射生效的提示，此时修改控制器、Razor视图代码保存后即可自动应用变更，无需重启容器
• 如果配置完成后仍不生效，删除本地关联的所有调试镜像、容器，清理解决方案后重新生成启动即可——旧的调试镜像不会自动同步新增的环境变量与挂载配置

常见排查点 #

• 如果使用WSL2后端运行Linux容器，不要将项目放在Windows加密目录、需要管理员权限的系统目录下，避免容器内进程无法读取文件变更事件
• 不要在Dockerfile的调试阶段添加dotnet publish、Razor视图预编译相关命令，预编译产物不会响应源文件修改
• 若使用自定义Docker网络，确认容器内dotnet watch进程与VS调试代理的通信端口未被网络策略拦截

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