VSCode 远程连接 Linux 服务器进行 C++ 调试的配置指南
在本地 Windows 环境下开发 C++ 项目时，经常需要部署到 Linux 服务器验证。手动上传代码不仅效率低，还难以利用 IDE 的断点调试功能。VSCode 的 Remote-SSH 扩展允许我们将本地编辑器直接连接到远程服务器，实现无缝的开发体验。
环境准备
首先确认本地和远程机器具备必要的工具链。VSCode 的 Remote-SSH 扩展简化了大部分配置工作，但底层依赖仍需满足。
必备组件：
- 本地机器：VSCode 1.35+（推荐最新稳定版）
- 远程服务器：Linux 系统（Ubuntu/CentOS 等）
- 网络：SSH 访问权限
在远程服务器上安装编译和调试工具：
sudo apt update && sudo apt install -y g++ gdb make cmake openssh-server
本地 VSCode 需安装两个核心扩展：
code --install-extension ms-vscode-remote.remote-ssh
code --install-extension ms-vscode.cpptools
若服务器在内网且无法访问外网，可提前下载
.vsix离线包进行安装。
SSH 连接配置
企业内网服务器往往无法直接通过公网 IP 访问，此时可通过跳板机建立隧道。修改或创建 ~/.ssh/config 文件来管理多主机连接。
Host dev-server
HostName 192.168.1.100
User developer
ProxyJump jump-host
IdentityFile ~/.ssh/id_rsa
Host jump-host
HostName public.example.com
User jumper
Port 2222
测试连接是否通畅：
ssh -T dev-server "echo '连接成功'"
在 VSCode 界面左下角点击「><」图标，选择「Connect to Host...」并输入别名 dev-server。首次连接会自动在远程安装服务端组件，耗时约 30-60 秒。
常见问题排查：
| 问题现象 | 解决方案 |
|---|---|
| 连接超时 | 检查跳板机配置和网络 ACL 规则 |
| 权限拒绝 | 确认密钥权限为 600：chmod 600 ~/.ssh/id_rsa |
| 主机密钥变更 | 删除 ~/.ssh/known_hosts 中对应条目 |
调试配置进阶
调试的核心在于正确配置 launch.json。针对 CMake 构建的项目，以下是一个完整的配置示例，重点在于指定程序路径和 GDB 后端设置。
{
"version": "0.2.0",
"configurations"
