Bootstrap

《用 VS Code 实现 SSH 远程连接 Linux,零基础一次搞定!》

作为开发者或运维人员,你是否经常需要连接 Linux 服务器进行代码调试或系统管理?告别繁琐的终端命令行工具,用 VS Code 的 SSH 远程开发功能,直接在编辑器里高效操作远程服务器!本文将手把手带你完成从安装到实战的全过程。

一、为什么选择 VS Code 远程开发?

  • 无缝集成:直接在 VS Code 中编辑远程文件,享受代码高亮、智能提示等功能

  • 终端内置:无需切换工具,编辑器内直接使用 Linux 终端

  • 插件同步:本地安装的插件可自动同步到远程环境

  • 跨平台支持:Windows/macOS/Linux 均可使用

二、准备工作

  1. 确保本地与 Linux 服务器网络互通

  2. 拥有服务器的 SSH 登录权限(账号密码或密钥)

  3. 推荐使用 SSH 密钥认证(更安全)

三、实战步骤详解

步骤 1:安装 VS Code

访问 VS Code 官网 下载对应版本:

  • Windows:双击 .exe 安装包

  • macOS:拖拽到 Applications 文件夹

  • Linux:使用 sudo apt install ./<file>.deb(Debian/Ubuntu)

步骤 2:安装 Remote - SSH 插件

  1. 打开 VS Code,点击左侧扩展图标(或 Ctrl+Shift+X

  2. 搜索框输入 Remote - SSH

  3. 选择 Microsoft 官方插件并点击安装

步骤 3:配置 SSH 连接

找到远程连接图标,安装插件才有

创建连接

选择第一个 如果第一个有中文 则 自己创建另外的目录存放 设置 指定自定义配置文件

创建连接成功后 ,点击连接

输入密码

点击接收

点击资源管理器,打开文件夹,选择你的工作区域

点击信任

四、常见问题排查

问题现象解决方案
连接超时检查防火墙/安全组是否开放SSH端口
认证失败确认密钥权限为600:chmod 600 ~/.ssh/id_rsa
提示缺失组件允许VS Code自动安装远程依赖
中文乱码在远程终端执行:export LANG=zh_CN.UTF-8

五、高效技巧

  1. 端口转发:通过SSH隧道访问Web服务(如localhost:8080)

  2. 多主机管理:在config文件中配置多个服务器

  3. 远程调试:直接调试运行在服务器上的Python/Node.js程序

  4. 设置同步:开启Settings Sync同步所有配置

六、总结

通过 VS Code 的 Remote-SSH 插件,我们实现了:

  • 可视化操作远程服务器文件

  • 本地编辑器直接修改云端代码

  • 终端与开发环境深度整合

现在就开始享受无缝衔接的远程开发体验吧!如果你遇到任何问题,欢迎在评论区留言讨论。

附:常用快捷键

  • Ctrl+~:快速打开/关闭终端

  • F1:打开命令面板

  • Ctrl+Shift+P:重新加载远程连接

;