使用VSCode进行远程开发的完整教程

安装Remote-SSH扩展并配置SSH主机信息，通过SSH连接远程服务器，在远程环境中打开项目并安装必要插件，即可流畅进行远程开发。

用vscode做远程开发其实不难，关键步骤理清楚了，几分钟就能连上服务器写代码。核心工具是vscode自带的remote - ssh扩展，通过ssh连接到远程机器，在远程环境里编辑、运行、调试代码，就像本地开发一样流畅。

1. 安装并配置 Remote - SSH 扩展

打开VSCode，在左侧扩展面板搜索 Remote - SSH，安装由Microsoft发布的官方插件。装好后左侧活动栏会出现一个“远程资源管理器”图标（小电脑带箭头）。

点击该图标，再点上方的“设置”按钮（齿轮图标），选择默认的SSH配置文件（通常是~/.ssh/config）进行编辑。

在配置文件中添加你的远程主机信息，例如：

保存后，重启VSCode或刷新远程资源管理器，你就能在列表里看到myserver这个主机名。

2. 连接到远程服务器

在远程资源管理器中点击myserver，VSCode会弹出一个新的窗口，开始通过SSH连接目标机器。首次连接会提示你确认服务器指纹，输入密码或使用密钥认证。

如果用了SSH密钥，确保私钥在本地~/.ssh/目录下，并且权限设为600（chmod 600 ~/.ssh/id_rsa）。

连接成功后，底部状态栏会变成绿色，显示“SSH: myserver”，说明你现在处于远程工作区。

github-mpc

验证并配置所需的MCP服务器（Atlassian和GitHub）以启用Product Guide Writer集成，缺失时引导设置。

下载

3. 在远程环境中打开项目

连接后，按Ctrl+Shift+P打开命令面板，输入“Open Folder”，选择在远程服务器上的项目路径，比如/home/yourname/myproject。

VSCode会把整个项目加载到远程窗口中。此时你看到的文件系统是服务器的，所有操作都在远程执行。

你可以像本地一样打开终端（Ctrl+``），它自动进入远程shell，执行git、python、npm等命令都是在服务器上运行。

4. 配置开发环境与常用设置

第一次打开远程项目时，VSCode可能会提示安装“VS Code Server”，这是自动完成的，无需干预。之后你可以为这个远程环境单独安装扩展，比如Python、Pylance、Docker等，这些扩展会运行在服务器上。

建议在远程工作区中创建.vscode/settings.json来保存特定配置，比如：

这样每次连接都能保持一致的开发体验。

基本上就这些。连上之后写代码、调试、跑服务都很顺，特别适合在云服务器、实验室主机或树莓派上开发。只要网络稳定，延迟几乎感觉不到。