云服务器：阿里云轻量级服务器(CentOS 7.6)

一、安装VSCode以及相关插件

vscode是微软官方的一款多语言 代码编辑器，其因为丰富而强大的插件而被非常多用户选中使用！

1、下载 vscode

官网下载地址：https://code.visualstudio.com/Download

打开之后可以看到上面这种，具体的解释如下，选择合适的版本即可：

操作系统	支持版本	安装类型	可用架构 / 格式	推荐场景 / 说明
Windows	Windows 10, 11	User Installer（用户安装器）	x64、Arm64	⭐ 最推荐：普通用户使用，无需管理员权限，安装在用户目录，升级方便
Windows	Windows 10, 11	System Installer（系统安装器）	x64、Arm64	需要管理员权限，适合公司电脑或多人共用
Windows	Windows 10, 11	.zip（便携版）	x64、Arm64	解压即用，不写入注册表，适合 U 盘携带或不想安装
Windows	Windows 10, 11	CLI（命令行版）	x64、Arm64	仅命令行工具，适合脚本、服务器或远程使用

---

操作系统	支持版本	安装类型	可用架构 / 格式	推荐场景 / 说明
Linux	Debian / Ubuntu 及其衍生版	.deb 包	x64、Arm32、Arm64	使用 sudo dpkg -i 或软件中心安装，Ubuntu 用户首选
Linux	Red Hat / Fedora / SUSE	.rpm 包	x64、Arm32、Arm64	使用 sudo dnf install 或 yum 安装
Linux	通用（多数发行版）	.tar.gz（压缩包）	x64、Arm32、Arm64	解压后手动运行，适合不想用包管理器的用户
Linux	Ubuntu 等	Snap	通过 Snap Store（x64 为主）	容器化安装，自动更新，兼容性好，但启动稍慢
Linux	通用	CLI（命令行版）	x64、Arm32、Arm64	纯命令行版本

---

操作系统	支持版本	安装类型	可用架构 / 格式	推荐场景 / 说明
macOS	macOS 12.0+（Monterey 及以上）	.dmg 安装包	Intel chip、Apple silicon、Universal（通用版）	⭐ 最推荐：拖拽到「应用程序」文件夹即可。Universal 版同时支持 Intel 和 M 系列芯片，文件稍大但最方便
macOS	macOS 12.0+	CLI（命令行版）	Intel chip、Apple silicon	安装后可在终端使用 code . 命令快速打开项目

---

勾选全部

---

2、下载相关插件

其中Remote - SSH - 远程登录Linux是一定要下载的

推荐插件

• Remote - SSH - 远程登录Linux

• C/C++ - 必装

• C/C++ Extension Pack - C/C++扩展包，下载直接安装，它包含了 vscode 编写 C/C++ 工程需要的插件（C/C++、C/C++ Themes、CMake、CMake Tools和Better C++ Syntax等），和以前比不需要一个个找了。

• C/C++ Themes - 主题设置，插件里面可以点击设置

• Chinese (Simplified) (简体中文)

• vscode-icons - 改变编辑器里面的文件图标

• filesize - 左下角显示源文件大小的插件

• Include AutoComplete - 自动头文件包含

• GBKtoUTF8 - 自动将 GBK 转换为 UTF8

• koroFileHeader - 头部注释添加/更新插件， 参考VScode自动添加注释
  

---

二、VSCode连接云服务的操作

（1）远程登入Linux

---

（2）输入连接指令

---

（3）更新ssh配置文件：

• 选择默认的第一个选项。
• 一般情况下，这个配置文件会自动配置好。没有自动配置的话，就手动配置。

---

（5）刷新开始连接

---

三、服务器中的配置文件

1. .vscode

作用： 存放当前项目的开发配置，例如调试、构建和插件推荐。
位置： .vscode 文件夹一般就位于「你当前在 VS Code 中打开的文件夹」的根目录下。
常见内容：

.vscode/
├── settings.json      # 项目配置
├── launch.json        # 调试配置
├── tasks.json         # 构建任务
├── extensions.json    # 推荐插件

理解： 告诉 VS Code “这个项目怎么运行和开发”。

---

2. .vscode-server

作用： 在远程开发（Remote SSH）时，存放 VS Code Server 和远程插件，负责真正执行代码。
位置： 服务器用户目录下，如 ~/.vscode-server。
目录示例：

.vscode-server/
├── bin/<commit-id>/      # VS Code Server 主程序
├── extensions/           # 远程插件
├── data/logs/            # 日志
├── data/Machine/         # 状态数据

特点：

• 自动生成，每个用户独立
• 与 VS Code 版本相关
• 不建议手动删除

理解： 本地 VS Code 只是界面，真正的代码运行在服务器上，通过 .vscode-server 控制和执行。

---

四、VS Code Remote SSH 连接失败问题

可能是版本惹的祸！

最近使用最新版本的 VS Code 连接远程服务器时，你可能会遇到：连接失败、无法启动 VS Code Server。但换成旧版本就能成功。为什么会这样呢？

---

1. VS Code Remote SSH 的工作原理

在远程开发模式下：

• 本地 VS Code： 只负责界面和操作
• 服务器端 VS Code Server (.vscode-server)： 真正执行代码、运行插件

当本地 VS Code 启动连接时，会检查服务器端 .vscode-server 是否存在对应版本，如果不存在，会尝试自动上传。

---

2. 为什么最新版本可能失败？

① 版本不兼容

• VS Code Server 与 VS Code 客户端紧密绑定
• 如果服务器环境不满足最新版本要求（如某些 Linux 系统库缺失），就会启动失败

② 权限或路径问题

• 新版本可能对目录权限、路径长度或符号链接要求更严格
• 旧版本容忍度更高，所以能成功

③ 插件和依赖变化

• 最新 VS Code Server 可能依赖最新的 Node.js 或系统库
• 旧版本不需要这些依赖

---

3. 解决思路

1. 升级服务器环境
   • 安装缺失的库，确保系统支持最新 VS Code Server
2. 使用兼容版本
   • 暂时使用旧版本 VS Code，保证稳定性
3. 手动安装 VS Code Server
   • 下载对应版本上传到服务器，避免自动下载失败

---

4. 核心总结

• VS Code Remote SSH 连接失败 ≠ 你操作错了
• 原因多半是客户端 VS Code 与服务器端环境/版本不匹配
• 解决办法：升级服务器或使用兼容版本