告别虚拟机黑窗口：VSCode Remote-SSH直连OpenEuler 20.03 LTS开发环境保姆级配置

weixin_33744854

332人浏览 · 2026-04-20 02:21:39

weixin_33744854 · 2026-04-20 02:21:39 发布

从零构建OpenEuler远程开发环境：VSCode+SSH全流程实战

第一次在无GUI的OpenEuler服务器上开发时，面对单调的命令行界面，我差点以为回到了上世纪。直到发现VSCode的Remote-SSH插件——这个改变开发者体验的神器。本文将带你完整走过从虚拟机配置到流畅开发的每一步，解决那些官方文档没告诉你的坑。

1. 环境准备：打造适合开发的OpenEuler系统

选择OpenEuler 20.03 LTS作为开发环境有其独特优势：长期支持、轻量级且对开发者友好。但默认安装可能缺少关键组件，我们需要先打好基础。

1.1 虚拟机安装与网络配置

在VMware Workstation中创建新虚拟机时，建议选择"自定义安装"而非典型安装，这能避免后续网络配置的麻烦。关键配置参数：

配置项	推荐值	说明
固件类型	UEFI	兼容性更好
磁盘类型	SCSI	性能更优
网络适配器	NAT模式	方便主机访问
内存分配	≥4GB	保证开发流畅度

安装完成后立即执行dnf update -y更新系统，这能避免后续很多依赖问题。

1.2 基础服务配置

OpenEuler默认安装了SSH服务，但需要调整配置以支持远程开发：

sudo vi /etc/ssh/sshd_config

确保以下参数已正确设置：

PermitRootLogin yes
PubkeyAuthentication yes
PasswordAuthentication yes

注意：生产环境应考虑禁用密码登录，仅使用密钥认证。开发环境为方便可暂时开启。

重启服务使配置生效：

sudo systemctl restart sshd

2. VSCode远程开发环境搭建

2.1 Remote-SSH插件安装与配置

在VSCode扩展商店搜索安装"Remote - SSH"插件后，按Ctrl+Shift+P调出命令面板，输入"Remote-SSH: Add New SSH Host"，按格式添加连接信息：

ssh root@your_vm_ip -A

连接配置文件中可添加优化参数：

Host OpenEuler-Dev
  HostName 192.168.1.100
  User root
  ForwardAgent yes
  ServerAliveInterval 60

2.2 常见连接问题排查

首次连接时可能遇到的典型错误及解决方案：

"tar命令未找到"错误
```
sudo dnf install tar -y
```
"Could not establish connection"
- 检查虚拟机防火墙状态：
```
sudo systemctl stop firewalld
```
- 验证网络连通性：
```
ping your_vm_ip
```

软件源配置问题 编辑源配置文件：

sudo vi /etc/yum.repos.d/openEuler.repo

使用官方源：

[base]
name=openEuler-20.03-LTS-SP1
baseurl=https://repo.openeuler.org/openEuler-20.03-LTS-SP1/OS/$basearch/
enabled=1
gpgcheck=1
gpgkey=https://repo.openeuler.org/openEuler-20.03-LTS-SP1/OS/$basearch/RPM-GPG-KEY-openEuler

3. 开发环境优化配置

3.1 必备开发工具安装

运行以下命令安装开发者工具链：

sudo dnf groupinstall "Development Tools" -y
sudo dnf install git cmake gdb -y

对于特定语言环境：

Python开发者：

sudo dnf install python3-pip -y
pip3 install --upgrade pip

C/C++开发者：
```
sudo dnf install gcc-c++ make -y
```

3.2 VSCode扩展同步安装

在远程环境中安装这些必备扩展：

C/C++ (Microsoft)
Python (Microsoft)
GitLens
Remote Development (Microsoft)

可通过命令批量安装：

code --install-extension ms-vscode.cpptools
code --install-extension ms-python.python

4. 高效开发工作流实践

4.1 终端集成技巧

VSCode内置终端已深度集成远程环境，但可以进一步优化：

使用`Ctrl+``快速切换终端

配置默认shell为zsh：

"terminal.integrated.defaultProfile.linux": "zsh"

启用分屏功能：Ctrl+\

4.2 文件传输与管理

无需额外工具，直接使用VSCode资源管理器：

拖放文件到资源管理器窗口即可上传
右键文件选择"Download"下载到本地
安装"SFTP"扩展可实现自动同步

4.3 调试配置示例

C++项目调试配置示例（.vscode/launch.json）：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "C++ Debug",
      "type": "cppdbg",
      "request": "launch",
      "program": "${workspaceFolder}/build/app",
      "args": [],
      "stopAtEntry": false,
      "cwd": "${workspaceFolder}",
      "environment": [],
      "externalConsole": false,
      "MIMode": "gdb",
      "setupCommands": [
        {
          "description": "Enable pretty-printing for gdb",
          "text": "-enable-pretty-printing",
          "ignoreFailures": true
        }
      ]
    }
  ]
}

5. 性能优化与高级配置

5.1 连接速度优化

在SSH配置中添加这些参数可显著提升响应速度：

Host *
  ControlMaster auto
  ControlPath ~/.ssh/sockets/%r@%h-%p
  ControlPersist 600
  Compression yes

5.2 资源监控配置

安装htop实时监控系统资源：

sudo dnf install htop -y

在VSCode中新建终端运行：

htop

5.3 自动化脚本示例

创建环境初始化脚本setup_dev.sh：

#!/bin/bash

# 安装基础工具
dnf install -y tar wget curl git

# 配置开发环境
dnf groupinstall -y "Development Tools"
dnf install -y gcc-c++ make cmake

# 安装Python环境
dnf install -y python3-pip
pip3 install --upgrade pip

echo "开发环境准备完成"

赋予执行权限：