vscode和Ubuntu远程连接
时间: 2025-05-31 09:55:28 浏览: 13
### VSCode 配置远程连接 Ubuntu SSH 远程开发教程
#### 一、安装并启用 SSH 服务
为了实现通过 VSCode 的 Remote Development 插件访问 Ubuntu 系统,首先需要在目标 Ubuntu 上安装并启动 SSH 服务。
1. **安装 OpenSSH Server**
使用以下命令安装 `openssh-server` 软件包:
```bash
sudo apt update && sudo apt install openssh-server
```
2. **启动 SSH 服务**
安装完成后,使用以下命令启动 SSH 服务:
```bash
sudo systemctl start ssh
```
3. **验证 SSH 是否正常工作**
可以通过检查进程列表确认 SSH 服务已启动:
```bash
sudo ps -e | grep ssh
```
如果看到类似 `sshd` 的条目,则表示服务正在运行[^1]。
---
#### 二、配置 VSCode 支持远程开发环境
VSCode 提供了一款名为 “Remote – SSH” 的扩展插件,可以轻松完成远程开发的配置。
1. **安装 Remote – SSH 扩展**
在 VSCode 中打开 Extensions 市场 (快捷键 Ctrl+Shift+X),搜索并安装 Microsoft 开发的官方插件:“Remote – SSH”。
2. **创建 SSH 配置文件**
在本地计算机上编辑 `.ssh/config` 文件,定义与目标 Ubuntu 主机的连接参数。如果该文件不存在,请手动创建它。
示例配置如下:
```plaintext
Host myubuntu
HostName <Ubuntu_IP_Address>
User <your_username_on_ubuntu>
Port 22
IdentityFile ~/.ssh/id_rsa
```
替换 `<Ubuntu_IP_Address>` 和 `<your_username_on_ubuntu>` 为实际值。其中 `IdentityFile` 是可选字段,用于指定私钥路径。
3. **测试 SSH 连接**
打开终端窗口,尝试直接通过 SSH 登录到目标主机:
```bash
ssh myubuntu
```
成功登录则说明配置无误[^2]。
---
#### 三、在 VSCode 中建立远程会话
当以上准备工作完成后,在 VSCode 中执行以下操作:
1. **选择目标主机**
按下组合键 `Ctrl+Shift+P` 或点击左侧活动栏中的绿色图标(代表 Remote Explorer),输入“Connect to Host”,然后从建议列表中选择之前配置的目标名称 (`myubuntu`)。
2. **初始化远程环境**
初次连接时,VSCode 将自动下载必要的工具链至远程机器,并提示重新加载窗口。此时按照指示操作即可进入远程模式。
3. **克隆项目或新建工程**
在远程环境中可以直接利用 Git 克隆仓库或者手工创建新目录作为工作区。
4. **构建 C++ 工程**
对于基于 CMake 构建系统的项目来说,推荐采用以下方式集成编译流程:
- 创建 `CMakeLists.txt` 文件描述依赖关系;
- 设置默认生成器为目标平台支持的形式(如 Makefile);
- 启动内置任务管理功能触发构建过程。
---
#### 四、调试程序
借助扩展 Marketplace 提供的相关组件能够极大简化复杂场景下的断点跟踪体验。具体做法包括但不限于以下几个方面:
- 添加 launch.json 条目明确指明待测对象及其附属选项;
- 结合 gdbserver 实现跨网络节点间的交互控制流传递机制[^1]。
```json
{
"version": "0.2.0",
"configurations": [
{
"name": "(gdb) Launch",
"type": "cppdbg",
"request": "launch",
"program": "${workspaceFolder}/build/main",
"args": [],
"stopAtEntry": false,
"cwd": "${workspaceFolder}",
"environment": [],
"externalConsole": true,
"MIMode": "gdb"
}
]
}
```
---
阅读全文
相关推荐


















