Mac系统下如何使用VS或Rider附加调试Docker容器内运行的dotnet进程

目前MacOS平台的主流.NET IDE暂未提供专门的一键附加已运行Docker容器的功能入口，你提到的Visual Studio for Mac、Rider默认引导的容器调试逻辑确实仅支持启动新容器实例，但可以通过以下方法实现对已有运行容器的调试：

前置配置 #

• 确保目标运行容器的基础镜像包含curl等基础网络工具，若镜像做了裁剪可先执行命令安装对应依赖：docker exec -it <容器ID/名称> apt update && apt install -y curl
• 容器内安装.NET官方调试工具vsdbg，执行命令：

docker exec -it <容器ID/名称> bash -c "curl -sSL https://aka.ms/getvsdbgsh | /bin/sh /dev/stdin -v latest -l ~/vsdbg"

方案1：Rider直接附加（2023.2及以上版本支持） #

• 打开Rider顶部菜单栏，选择运行→附加到进程
• 进程列表左上角的筛选下拉框，选择Docker，列表会自动加载所有运行中Docker容器内的进程
• 筛选找到你的.NET应用进程（进程名和项目生成的程序集名称一致），点击附加
• 弹出调试器选择弹窗时，选择.NET Core 调试器，等待数秒即可完成连接进入调试状态

方案2：VS for Mac手动映射调试 #

• 先在容器内启动vsdbg调试服务器，执行命令：

docker exec -d <容器ID/名称> ~/vsdbg/vsdbg --interpreter=vscode --server --port=4711

• 执行端口转发，将容器调试端口映射到本地：

docker port forward add <容器ID/名称> --host-port 4711 --container-port 4711

• 打开Visual Studio for Mac，顶部菜单栏选择运行→附加到进程
• 连接类型选择.NET Core Debugger，地址填写localhost:4711，找到对应.NET进程后点击附加即可

方案3：半自动化脚本简化流程 #

你可以将前置配置、调试服务启动、端口映射的逻辑封装为shell脚本，后续调试无需重复执行多步命令，示例脚本如下：

#!/bin/bash
# 入参为目标容器ID/名称
CONTAINER_TARGET=$1

# 检查容器是否存在
if ! docker ps --filter "name=$CONTAINER_TARGET" | grep -q $CONTAINER_TARGET; then
    echo "目标容器未运行，请检查容器名称/ID"
    exit 1
fi

# 安装vsdbg（若不存在）
docker exec $CONTAINER_TARGET bash -c "if [ ! -d ~/vsdbg ]; then curl -sSL https://aka.ms/getvsdbgsh | /bin/sh /dev/stdin -v latest -l ~/vsdbg; fi"

# 启动调试服务器
docker exec -d $CONTAINER_TARGET ~/vsdbg/vsdbg --interpreter=vscode --server --port=4711

# 配置端口映射
docker port forward add $CONTAINER_TARGET --host-port 4711 --container-port 4711

echo "调试服务已启动，可在IDE中附加到localhost:4711进行调试"

保存为debug-dotnet-container.sh后，添加执行权限chmod +x debug-dotnet-container.sh，使用时直接执行./debug-dotnet-container.sh <你的容器ID/名称>即可。

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