当前位置：首页 > news >正文

告别虚拟机黑窗口：VSCode Remote-SSH直连OpenEuler 20.03 LTS开发环境搭建全记录

news 2026/7/17 9:37:49

从零构建OpenEuler云端开发环境：VSCode Remote-SSH实战指南

当你在VMware中安装完OpenEuler服务器版后，面对漆黑的控制台窗口是否感到一丝不安？作为开发者，我们早已习惯了现代IDE的代码补全、语法高亮和插件生态。本文将带你用VSCode的Remote-SSH功能，将本地开发体验无缝延伸到OpenEuler服务器，实现真正的"云端原生开发"。

1. 环境准备与基础配置

在开始之前，确保你已经完成OpenEuler 20.03 LTS的基础安装。不同于桌面版，服务器安装通常会选择最小化安装，这意味着许多开发常用工具（如tar、wget等）可能缺失。我们先来解决这些基础依赖问题。

1.1 配置OpenEuler软件源

OpenEuler默认可能未启用官方软件仓库，这会导致后续工具安装失败。我们需要先配置正确的软件源：

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

将以下内容写入配置文件（注意根据你的OpenEuler版本选择正确的仓库地址）：

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

保存后更新软件包缓存：

sudo dnf makecache

1.2 安装基础开发工具

接下来安装开发必备的基础工具包：

sudo dnf install -y tar gzip wget curl git vim

提示：如果遇到依赖问题，可以尝试先安装epel-release扩展仓库：sudo dnf install epel-release

2. SSH服务深度优化

默认的SSH配置虽然可用，但为了获得更好的远程开发体验，我们需要对SSH服务进行一些优化调整。

2.1 修改SSH服务器配置

编辑SSH服务配置文件：

sudo vi /etc/ssh/sshd_config

建议修改以下关键参数：

Port 22 PermitRootLogin prohibit-password PubkeyAuthentication yes AuthorizedKeysFile .ssh/authorized_keys PasswordAuthentication no ChallengeResponseAuthentication no UsePAM yes AllowAgentForwarding yes AllowTcpForwarding yes GatewayPorts yes X11Forwarding yes

修改完成后重启SSH服务：

sudo systemctl restart sshd

2.2 配置SSH密钥认证

相比密码认证，密钥认证更安全且方便。在本地机器生成密钥对：

ssh-keygen -t ed25519

将公钥上传到OpenEuler服务器：

ssh-copy-id -i ~/.ssh/id_ed25519.pub username@your-server-ip

测试密钥登录是否成功：

ssh username@your-server-ip

3. VSCode Remote-SSH环境搭建

现在我们已经准备好了服务器端的SSH环境，接下来配置VSCode的远程开发功能。

3.1 安装必要扩展

在VSCode中安装以下扩展：

Remote - SSH
Remote Development（扩展包，包含SSH功能）

3.2 配置SSH连接

在VSCode中按下F1，输入"Remote-SSH: Open Configuration File"，选择你的SSH配置文件（通常是~/.ssh/config），添加服务器配置：

Host my-openeuler HostName your-server-ip User username IdentityFile ~/.ssh/id_ed25519 ForwardAgent yes

保存后，在VSCode左侧活动栏点击"远程资源管理器"，选择"SSH Targets"，找到你刚配置的主机并连接。

3.3 解决常见连接问题

首次连接可能会遇到各种问题，以下是常见问题及解决方案：

问题现象	可能原因	解决方案
"Could not establish connection"	服务器未安装必要的辅助工具	在服务器安装：`sudo dnf install -y openssh-server tar gzip`
"Failed to parse remote port"	SSH隧道建立失败	检查服务器sshd_config中的AllowTcpForwarding是否为yes
连接超时	防火墙阻止	检查服务器防火墙规则：`sudo firewall-cmd --list-all`

4. 高效开发环境配置

成功连接后，我们还需要优化开发环境，使其真正达到生产级效率。

4.1 安装开发工具链

根据你的开发语言安装相应工具链：

C/C++开发：

sudo dnf install -y gcc gcc-c++ make cmake gdb

Python开发：

sudo dnf install -y python3 python3-pip python3-devel

Java开发：

sudo dnf install -y java-11-openjdk-devel maven

4.2 配置开发环境

在远程环境中安装VSCode扩展：

按下Ctrl+Shift+X打开扩展面板
搜索并安装你需要的语言扩展（如Python、C++等）

这些扩展将直接安装在远程环境中，而非本地机器。

4.3 性能优化技巧

为了获得更流畅的远程开发体验，可以尝试以下优化：

禁用不必要的文件监视：在VSCode设置中搜索files.watcherExclude，添加不需要实时监视的文件模式。
使用SSH压缩：在SSH配置中添加：
```
Compression yes
```
调整自动保存间隔：将files.autoSave设置为afterDelay，并根据网络状况调整延迟时间。

5. 高级技巧与最佳实践

5.1 端口转发与调试

Remote-SSH支持端口转发，这对调试Web应用特别有用。在VSCode的"端口"视图中，可以轻松添加转发规则。

例如，转发本地8080到远程80端口：

Host my-openeuler HostName your-server-ip LocalForward 8080 localhost:80

5.2 多项目工作区管理

对于同时开发多个相关项目的情况，可以创建.code-workspace文件来管理工作区：

{ "folders": [ { "path": "/path/to/project1" }, { "path": "/path/to/project2" } ], "settings": { "remote.SSH.defaultExtensions": [ "ms-python.python", "ms-vscode.cpptools" ] } }

5.3 自动化环境配置

为了确保团队成员或新机器能快速获得一致的开发环境，可以创建安装脚本：

#!/bin/bash # 安装基础工具 sudo dnf install -y tar gzip wget curl git vim # 安装开发工具链 sudo dnf install -y gcc gcc-c++ make cmake python3 python3-pip # 配置SSH sudo sed -i 's/#AllowAgentForwarding yes/AllowAgentForwarding yes/' /etc/ssh/sshd_config sudo systemctl restart sshd # 安装常用Python包 pip3 install --user flake8 autopep8 pylint

将这个脚本保存为setup-dev-env.sh并设置为可执行：