在跨平台开发场景中，使用VS2017调试运行在Linux系统上的.NET Core程序可以大幅提升问题排查效率，下面介绍完整的操作流程。
环境准备
首先需要确保两端的运行环境符合要求：
- Windows端安装VS2017，且勾选.NET Core跨平台开发 workload，版本建议为15.9及以上。
- Linux端安装.NET Core运行时和SDK，本文以Ubuntu 18.04为例，其他发行版步骤类似。
- Linux端需要开放SSH服务，并且安装调试所需的组件。
Linux端配置
安装调试组件
在Linux终端执行以下命令安装VS2017调试所需的依赖：
# 安装SSH服务 sudo apt-get update sudo apt-get install -y openssh-server sudo systemctl enable ssh sudo systemctl start ssh # 安装.NET Core调试工具 sudo apt-get install -y unzip curl curl -sSL https://dot.net/v1/dotnet-install.sh | bash /dev/stdin --channel 2.1 --install-dir /usr/share/dotnet sudo ln -s /usr/share/dotnet/dotnet /usr/bin/dotnet # 安装VS调试所需的vsdbg工具 curl -sSL https://aka.ms/getvsdbgsh | bash /dev/stdin -v latest -l /usr/share/vsdbg
发布.NET Core程序
将需要调试的.NET Core项目发布到Linux系统，假设项目名为TestApp，执行以下命令：
# 在Windows端项目目录执行发布命令，输出到Linux的/home/user/test目录 dotnet publish -c Debug -r linux-x64 --self-contained false -o /mnt/linux_share/test # 若使用SCP传输，命令如下 scp -r /mnt/linux_share/test user@192.168.0.1:/home/user/
VS2017项目配置
创建调试配置
打开VS2017中的.NET Core项目，按照以下步骤配置远程调试：
- 右键点击项目，选择属性，切换到调试选项卡。
- 点击新建配置，选择.NET Core 远程调试。
- 填写Linux服务器的IP地址、SSH端口（默认22）、登录用户名和密码。
- 设置远程项目的部署路径，例如/home/user/test。
- 设置启动程序路径，例如/home/user/test/TestApp.dll。
配置参数说明
| 配置项 | 说明 |
|---|---|
| 远程主机 | Linux服务器的IP地址，例如192.168.0.1 |
| SSH端口 | SSH服务监听的端口，默认22 |
| 用户名 | Linux系统的登录用户名 |
| 部署目录 | 程序在Linux上的存放路径 |
| 启动命令 | 启动程序的命令，通常为dotnet 程序名.dll |
启动调试
完成配置后，在VS2017中设置断点，点击调试按钮即可启动远程调试：
- VS会自动将本地的调试符号同步到Linux端，无需手动复制pdb文件。
- 程序启动后，命中断点时VS会显示当前的变量值、调用栈等信息，和本地调试体验一致。
- 可以在即时窗口中执行表达式，查看程序运行状态。
常见问题排查
连接失败
如果VS无法连接到Linux服务器，检查以下内容：
- Linux端SSH服务是否正常运行，使用ssh user@ip测试连接。
- 防火墙是否放行了SSH端口，Ubuntu可使用sudo ufw allow 22开放端口。
- 用户名和密码是否正确，避免使用root用户直接调试。
断点不生效
断点无法命中的常见原因：
- 发布时使用的是Debug配置，Release配置不会生成完整的调试符号。
- 本地代码和Linux上的程序版本不一致，重新发布并部署程序。
- vsdbg工具安装路径不正确，可在VS调试输出窗口查看具体错误信息。
程序启动报错
如果程序启动失败，检查：
- Linux端是否安装了对应版本的.NET Core运行时，使用dotnet --version查看版本。
- 程序依赖的库是否在Linux上存在，避免引用Windows特有的原生库。
- 部署目录的权限是否正确，确保执行用户有读写和执行权限。