VSCode连接Docker中Dart进程时如何在本地代码上设置断点

问题核心原因 #

断点无法生效是因为Dart VM服务返回的源码路径为容器内的绝对路径（/app/xxx.dart），VSCode无法将其和Windows本地的项目源码路径做关联，因此本地断点无法绑定到容器内运行的代码。 #

完整解决方案 #

1. 修正launch.json配置，增加路径映射 #

在attach配置中新增additionalSourcePathMappings字段，建立容器内路径和本地路径的映射关系，同时指定VM服务端口：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Docker: Attach to Dart Proccess",
            "type": "dart",
            "request": "attach",
            "port": 10000,
            "additionalSourcePathMappings": {
                // 左侧为容器内的源码根目录，右侧替换为你本地项目的根目录绝对路径
                // Windows路径注意反斜杠要转义，或者直接用正斜杠
                "/app": "D:\\your_local_project_path\\dart_server"
            }
        }
    ]
}

2. 调整docker-compose挂载规则 #

你当前只挂载了./bin目录，本地其他目录（如lib等）的修改无法同步到容器，同时也会导致路径匹配范围不全，修改volumes配置如下：

volumes:
  # 挂载整个项目根目录到容器内的/app
  - ./:/app
  # 增加匿名卷避免覆盖容器内的依赖缓存，防止Windows和Linux依赖不兼容的问题
  - /app/.dart_tool
  - /app/.pub_cache

3. 优化Dart启动命令 #

调整VM服务参数，允许外部访问、关闭调试认证码，避免每次启动后需要手动输入认证码才能attach：

dart run --enable-vm-service=0.0.0.0:10000 --disable-service-auth-codes ./bin/server.dart

4. Windows环境额外注意事项 #

• 打开Docker Desktop设置，在「资源管理-文件共享」中开启你项目所在磁盘的共享权限，否则挂载会失效
• 如果你使用WSL2作为Docker后端，建议将项目源码放到WSL文件系统中，既可以提升IO性能，也能避免Windows和Linux路径格式不匹配的问题
• 注意文件名大小写完全一致，Linux容器内路径大小写敏感，Windows本地默认大小写不敏感，文件名不一致会导致路径映射失效

验证方法 #

修改配置后执行docker-compose up --build重建容器启动服务，attach完成后在本地的接口处理逻辑处打断点，访问对应接口即可触发断点中断。

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