VS Code远程开发真香指南：SSH连接服务器全攻略（手把手教学）

前言

还在用Xshell+FTP搞远程开发？太out啦！今天教大家用VS Code直连服务器写代码（丝滑到飞起~），直接在本地编辑器修改远程文件、调试程序，还能用上所有熟悉的插件！（文末附赠避坑指南，都是血泪经验）

一、准备工作

1. 装好这俩扩展（必装！）

在扩展商店搜索安装：

• Remote - SSH（微软官方出品）
• Remote Development（扩展包，建议整套安装）

（👉小贴士：如果连不上服务器，可以试试安装老版本扩展，有时候新版会有兼容性问题）

二、配置连接三部曲

步骤1：创建SSH配置文件

1. 按F1打开命令面板
2. 输入Remote-SSH: Open SSH Configuration File
3. 选择C:\Users\你的用户名\.ssh\config（Windows）或~/.ssh/config（Mac/Linux）

示例配置（直接复制修改）：

Host my-server  # 自定义服务器昵称
    HostName 192.168.1.100  # 服务器IP/域名
    User root               # 登录用户名
    Port 22                 # SSH端口（默认22可不写）
    IdentityFile ~/.ssh/id_rsa  # 密钥路径（密码登录可删这行）

步骤2：连接服务器

1. 侧边栏点开远程资源管理器
2. 右键刚配置的my-server选Connect
3. 首次连接会弹出选择服务器类型（选Linux）

（⚠️注意：如果卡在Setting up SSH Host XX:Copying VS Code Server...，八成是网络问题，开个梯子试试）

步骤3：打开远程目录

连接成功后：

1. 点击文件 -> 打开文件夹
2. 输入服务器上的项目路径（如/home/project）
3. 现在可以像操作本地文件一样写代码了！

三、高级玩法（打工人必备）

1. 免密登录设置（告别输密码）

# 本地终端执行：
ssh-keygen -t rsa  # 连按三次回车
ssh-copy-id -i ~/.ssh/id_rsa.pub user@host  # 输入一次密码

（💡个人强烈推荐这种方式，既安全又省去每次输密码的麻烦（谁记密码谁头疼是吧~））

2. 端口转发妙用

在config文件添加：

LocalForward 3306 localhost:3306  # 把远程MySQL映射到本地3306
LocalForward 8888 localhost:8888  # Jupyter Notebook直连

3. 多服务器管理

同一个config文件可配置多个Host：

Host dev-server
    HostName dev.example.com
    User devuser

Host prod-server
    HostName 121.36.45.78
    User deploy
    Port 2222

四、常见翻车现场救援

场景1：连不上提示Permission denied

• 检查用户名/密码是否正确（大小写敏感！）
• 密钥权限问题：chmod 600 ~/.ssh/id_rsa
• 服务器SSH服务状态：sudo systemctl status ssh

场景2：中文乱码

在远程服务器执行：

echo 'export LANG="zh_CN.UTF-8"' >> ~/.bashrc
source ~/.bashrc

场景3：插件不生效

记住这两个规则：

1. 本地装的插件只影响本地
2. 远程连接后装的插件会安装在服务器端
   （💡建议在远程连接状态下重新安装必要插件）

五、性能优化小技巧

1. 关闭文件监控（大项目必备）：

"remote.SSH.useLocalServer": false

2. 增加重连次数：

"remote.SSH.maxReconnectionAttempts": 10

3. 启用压缩传输（网络差时有用）：

Host *
    Compression yes

结语

现在你可以优雅地瘫在椅子上，喝着咖啡调试远程代码了（老板绝对看不出你在摸鱼）！如果遇到其他奇葩问题，记住万能三连：

1. 检查网络
2. 查看日志（CTRL+` 打开终端）
3. 重启大法好

（🤫偷偷说：用熟了这套操作，你甚至可以在地铁上用手机连服务器改bug…别问我是怎么知道的）