作为开发者或运维人员,你是否经常需要连接 Linux 服务器进行代码调试或系统管理?告别繁琐的终端命令行工具,用 VS Code 的 SSH 远程开发功能,直接在编辑器里高效操作远程服务器!本文将手把手带你完成从安装到实战的全过程。
一、为什么选择 VS Code 远程开发?
-
无缝集成:直接在 VS Code 中编辑远程文件,享受代码高亮、智能提示等功能
-
终端内置:无需切换工具,编辑器内直接使用 Linux 终端
-
插件同步:本地安装的插件可自动同步到远程环境
-
跨平台支持:Windows/macOS/Linux 均可使用
二、准备工作
-
确保本地与 Linux 服务器网络互通
-
拥有服务器的 SSH 登录权限(账号密码或密钥)
-
推荐使用 SSH 密钥认证(更安全)
三、实战步骤详解
步骤 1:安装 VS Code
访问 VS Code 官网 下载对应版本:
-
Windows:双击
.exe
安装包 -
macOS:拖拽到 Applications 文件夹
-
Linux:使用
sudo apt install ./<file>.deb
(Debian/Ubuntu)
步骤 2:安装 Remote - SSH 插件
-
打开 VS Code,点击左侧扩展图标(或
Ctrl+Shift+X
) -
搜索框输入 Remote - SSH
-
选择 Microsoft 官方插件并点击安装
步骤 3:配置 SSH 连接
找到远程连接图标,安装插件才有
创建连接![]()
选择第一个 如果第一个有中文 则 自己创建另外的目录存放 设置 指定自定义配置文件![]()
创建连接成功后 ,点击连接![]()
输入密码
点击接收
点击资源管理器,打开文件夹,选择你的工作区域
点击信任
四、常见问题排查
问题现象 | 解决方案 |
---|---|
连接超时 | 检查防火墙/安全组是否开放SSH端口 |
认证失败 | 确认密钥权限为600:chmod 600 ~/.ssh/id_rsa |
提示缺失组件 | 允许VS Code自动安装远程依赖 |
中文乱码 | 在远程终端执行:export LANG=zh_CN.UTF-8 |
五、高效技巧
-
端口转发:通过SSH隧道访问Web服务(如localhost:8080)
-
多主机管理:在config文件中配置多个服务器
-
远程调试:直接调试运行在服务器上的Python/Node.js程序
-
设置同步:开启Settings Sync同步所有配置
六、总结
通过 VS Code 的 Remote-SSH 插件,我们实现了:
-
可视化操作远程服务器文件
-
本地编辑器直接修改云端代码
-
终端与开发环境深度整合
现在就开始享受无缝衔接的远程开发体验吧!如果你遇到任何问题,欢迎在评论区留言讨论。
附:常用快捷键
-
Ctrl+~
:快速打开/关闭终端 -
F1
:打开命令面板 -
Ctrl+Shift+P
:重新加载远程连接