VSCode 通过 Remote-SSH 扩展实现远程开发,本地界面操作远程服务器代码:先配置 SSH 主机并安装扩展,再连接启动远程 VS Code Server,所有编辑调试均在服务器执行,本地仅显示输入。

VSCode 的远程开发功能让你能在本地界面操作远程服务器上的代码,SSH 连接是最常用、最稳定的方式。核心在于:本地 VSCode 通过 SSH 启动远程的 VS Code Server,所有编辑、调试、终端操作实际运行在服务器上,本地只负责显示和输入。
前提条件:确保 SSH 可用
服务器需开启 SSH 服务(默认端口 22),且你有可登录的用户账号和对应权限(建议使用密钥认证,更安全也免输密码)。
- 本地能通过终端执行 ssh user@host 成功登录(如
ssh ubuntu@192.168.1.100) - 服务器上已安装 Git、基础编译工具(如 gcc、make)、Python/Node.js 等项目依赖环境(VS Code Server 会自动安装,但语言运行时需手动配好)
- 推荐配置 SSH 密钥免密登录:用
ssh-keygen生成密钥,再用ssh-copy-id user@host推送公钥
安装 Remote-SSH 扩展
这是 VSCode 官方提供的远程开发入口,必须先装好。
- 打开 VSCode → 左侧扩展面板(或 Ctrl+Shift+X)→ 搜索 Remote - SSH
- 安装由 Microsoft 发布的官方扩展(图标是锁+终端)
- 安装后,左下角状态栏会出现一个绿色的远程连接图标(>),点击即可开始配置
连接并打开远程文件夹
连接过程分两步:配置主机信息 → 连接并选择工作目录。
ECTouch是上海商创网络科技有限公司推出的一套基于 PHP 和 MySQL 数据库构建的开源且易于使用的移动商城网店系统!应用于各种服务器平台的高效、快速和易于管理的网店解决方案,采用稳定的MVC框架开发,完美对接ecshop系统与模板堂众多模板,为中小企业提供最佳的移动电商解决方案。ECTouch程序源代码完全无加密。安装时只需将已集成的文件夹放进指定位置,通过浏览器访问一键安装,无需对已有
- 点击左下角远程图标 → 选 Connect to Host… → 再选 Add New SSH Host…
- 输入格式为:user@host 或 user@host:port(如
ubuntu@192.168.1.100:2222) - 选择 SSH 配置文件位置(默认 ~/.ssh/config,也可新建)→ VSCode 会把这条记录写入其中
- 再次点击远程图标 → 从列表中选刚添加的主机 → 输入密码或使用密钥解锁 → 等待 VS Code Server 自动下载并启动(首次较慢,后续快)
- 连接成功后,按 Ctrl+K Ctrl+O 打开远程文件夹(如
/home/ubuntu/myproject),即可像本地一样编辑、运行、调试
小技巧与常见注意点
连接不是一劳永逸,有些细节会影响体验。
- 终端默认是远程 shell:新打开的集成终端直接运行在服务器上,
pwd显示的是远程路径 - 扩展要分“本地”和“远程”:部分扩展(如 ESLint、Prettier)需在远程安装才生效,右键扩展 → Install on SSH: hostname
- 如果连接卡在“Setting up remote environment”,检查服务器磁盘空间、网络连通性,或手动在服务器上运行
curl -fsSL https://aka.ms/install-vscode-server-stable | bash - 想快速切换本地/远程工作区:点击远程图标 → Close Remote Connection 即可退回到纯本地模式
基本上就这些。不需要同步代码、不依赖 FTP,也不用折腾 Web IDE,SSH 连上就能写真实环境里的程序。不复杂但容易忽略配置细节,理清逻辑后效率提升很明显。







