用 VSCode 直接在服务器上开发,手把手教你上手!

我最近在搞一个项目,需要直接在 Linux 服务器上开发。以前都是写完代码再上传,特别麻烦。后来发现 VSCode 有个超好用的插件 Remote - SSH,可以直接在本地 VSCode 编辑远程服务器文件,修改马上生效,简直效率炸裂!
今天我就来手把手教大家怎么搞定这个环境。


第一步:生成 SSH Key 并上传到服务器

首先,你得保证你能用 SSH 免密码登录服务器,不然 VSCode 每次都要输密码,太烦了。

  1. 打开 Windows CMD 或 PowerShell,生成 SSH Key:
ssh-keygen -t rsa -b 4096 -C "你的邮箱"

一路回车,默认保存到 C:\Users\你的用户名\.ssh\id_rsa,密码可以留空,方便 VSCode 直接用。

  1. 上传公钥到服务器:

在本地打开公钥文件:

notepad C:\Users\你的用户名\.ssh\id_rsa.pub

复制里面的内容,然后 SSH 登录服务器:

ssh root@你的服务器IP

在服务器上执行:

mkdir -p ~/.ssh
echo "刚刚复制的公钥内容" >> ~/.ssh/authorized_keys
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys

注意:私钥永远不要上传到服务器,只上传公钥。

测试一下:

ssh -i C:\Users\你的用户名\.ssh\id_rsa root@你的服务器IP

如果能直接登录,不用密码就成功了。


第二步:安装 VSCode 插件

打开 VSCode → 左侧扩展栏 → 搜索 Remote - SSH → 安装。

安装完重启 VSCode。


第三步:配置 SSH 连接

  1. 打开命令面板 Ctrl + Shift + P → 输入:
Remote-SSH: Add New SSH Host...
  1. 弹出输入框,填:
ssh root@你的服务器IP -i C:\Users\你的用户名\.ssh\id_rsa
  1. 选择配置文件保存到 C:\Users\你的用户名\.ssh\config

之后 VSCode 会生成一条配置,例如:

Host myserver
    HostName 你的服务器IP
    User root
    IdentityFile C:\Users\你的用户名\.ssh\id_rsa

第四步:连接服务器

  1. 打开命令面板 Ctrl + Shift + PRemote-SSH: Connect to Host... → 选择 myserver
  2. 第一次连接 VSCode 会在服务器后台安装 VSCode Server(只需一次)
  3. 成功后,左下角显示绿色 >< SSH: myserver

第五步:打开项目开始开发

  1. VSCode 文件资源管理器 → 打开文件夹 → 输入服务器项目路径,比如:
/root/my_project
  1. 现在你可以像本地一样编辑文件,保存后服务器上立即生效!

第六步:内置终端 & 调试

VSCode 终端直接连到服务器:

Ctrl + `

可以直接运行:

python3 app.py
node server.js
git pull

调试、运行、上传都不用离开 VSCode。


小技巧

  • 如果你想同步本地改动,也可以用 SFTP 插件
  • 服务器大项目第一次打开可能会有点卡,耐心等一下
  • 如果是 Web 项目,记得端口映射或者用 0.0.0.0 监听

总结

我以前一直在本地写完上传服务器,非常麻烦。现在直接在 VSCode 里打开远程文件,调试、运行、修改都直接生效,效率提升好几倍。
Remote - SSH 插件真的太香了,强烈推荐大家试试!

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐