如何利用 VSCode 进行远程服务器上的开发工作？-VSCode-PHP中文网

如何利用 VSCode 进行远程服务器上的开发工作？

狼影

发布： 2025-09-17 23:45:01

原创

348人浏览过

使用VSCode进行远程开发需配置Remote-SSH插件，通过SSH连接服务器实现本地编辑、远程执行。安装Remote-SSH插件后，点击左下角绿色图标添加SSH主机，输入ssh user@your_server_ip命令并完成身份验证。连接成功后选择“Open Folder”打开远程项目，所有操作均在远程执行。为提升体验，应安装语言支持等扩展，配置settings.json同步偏好设置，使用SSH密钥免密登录，并通过-L参数实现端口转发。对于依赖复杂的项目，可结合Dev Containers和Docker构建一致开发环境。调试时以Python为例，需在远程安装debugpy，配置launch.json中的连接信息与路径映射，在代码中启动调试监听，再通过VSCode附加调试器。面对网络不稳定，推荐使用Mosh替代SSH以增强连接稳定性，配合tmux或screen保持会话不中断；启用自动保存、定期rsync同步及Git版本控制防止数据丢失。安全性方面，建议禁用密码登录、仅用SSH密钥认证，在sshd_config中设置PasswordAuthentication no；部署防火墙限制访问端口，定期更新系统补丁，安装Fail2ban防御暴力破解，并启用两因素认证进一步加固安全。

如何利用 vscode 进行远程服务器上的开发工作？

使用 VSCode 进行远程服务器开发，关键在于利用其强大的插件系统，尤其是 Remote - SSH 插件，实现本地编辑、远程执行和调试。配置好 SSH 连接后，就能像操作本地文件一样操作远程服务器上的代码，极大地提升开发效率。

Remote - SSH 插件配置与使用

首先，确保你的本地机器和远程服务器之间可以通过 SSH 连接。然后在 VSCode 中安装 "Remote - SSH" 插件。安装完成后，点击 VSCode 左下角的绿色图标，选择 "Connect to Host..."，然后选择 "Add New SSH Host..."。

输入你的 SSH 连接命令，例如

ssh user@your_server_ip

登录后复制

。VSCode 会提示你输入密码（或者使用 SSH 密钥进行身份验证，更安全）。连接成功后，你可以选择 "Open Folder..."，打开远程服务器上的项目文件夹。

此时，VSCode 会在本地打开一个窗口，但所有文件操作、代码执行、调试等都在远程服务器上进行。你可以像操作本地文件一样编辑代码，保存后会自动同步到远程服务器。

如何配置 VSCode 才能获得最佳的远程开发体验？

配置 VSCode 的最佳远程开发体验，需要考虑以下几个方面：

安装必要的插件： 除了 Remote - SSH，还可以安装一些常用的开发插件，例如 Python、JavaScript、Go 等语言的插件，以及代码格式化工具、代码片段工具等。这些插件可以帮助你提高开发效率。
配置 settings.json： VSCode 的
```
settings.json
```
登录后复制
文件可以配置各种编辑器行为，例如代码缩进、自动保存、字体大小等。你可以根据自己的喜好进行配置。建议将一些常用的配置项同步到远程服务器，以便在远程开发时也能获得一致的体验。Remote - SSH 插件会自动将部分配置同步到远程服务器，但你也可以手动配置。
使用 SSH 密钥： 使用 SSH 密钥可以避免每次连接都需要输入密码，提高安全性。你可以使用
```
ssh-keygen
```
登录后复制
命令生成 SSH 密钥，并将公钥复制到远程服务器的
```
~/.ssh/authorized_keys
```
登录后复制
文件中。
端口转发： 如果你的远程服务器上运行着一些服务，例如数据库、Web 服务器等，你可以使用 SSH 端口转发将这些服务映射到本地机器，以便在本地进行访问和调试。可以使用
```
-L
```
登录后复制
参数进行端口转发，例如
```
ssh -L 8080:localhost:3000 user@your_server_ip
```
登录后复制
将远程服务器上的 3000 端口映射到本地机器的 8080 端口。
利用 Dev Containers： 如果你的项目依赖于特定的环境，例如特定的操作系统版本、特定的软件包版本等，可以使用 Dev Containers 来创建一个隔离的开发环境。Dev Containers 使用 Docker 镜像作为开发环境的基础，可以确保开发环境的一致性。VSCode 的 Remote - Containers 插件可以帮助你创建和管理 Dev Containers。

远程开发时如何进行代码调试？

VSCode 的远程调试功能非常强大，可以让你像调试本地代码一样调试远程服务器上的代码。

以 Python 为例，首先需要在远程服务器上安装

debugpy

登录后复制

库：

pip install debugpy

登录后复制

。然后在 VSCode 中创建一个

launch.json

登录后复制

文件，配置调试器。

海纳企业网站管理系统2.0 Ultimate

海纳企业网站管理系统(HituxCMS)是海纳网络工作室(Hitux.com)专业为企业建站而开发的一款网站程序。该系统采用最简单易用的asp+access进行搭建，拥有完善的网站前后台，并特别根据企业网站的特点开发出独具特色的栏目和功能。HituxCMS是企业建站的绝佳选择！系统三大特色： 1、全静态：全站生成.html静态页面。降低服务器压力，增强百度收录。 2、高优化：特别针对搜索引擎进行

查看详情

一个简单的

launch.json

登录后复制

文件如下所示：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Python: Remote Attach",
      "type": "python",
      "request": "attach",
      "connect": {
        "host": "localhost",
        "port": 5678
      },
      "pathMappings": [
        {
          "localRoot": "${workspaceFolder}",
          "remoteRoot": "/path/to/your/project"
        }
      ]
    }
  ]
}

登录后复制

其中，

host

登录后复制

和

port

登录后复制

分别指定了远程调试服务器的地址和端口。

pathMappings

登录后复制

指定了本地代码路径和远程代码路径的映射关系。

然后在远程服务器上运行你的 Python 代码，并使用

debugpy

登录后复制

启动调试服务器：

import debugpy

debugpy.listen(("0.0.0.0", 5678))
print("Waiting for debugger attach...")
debugpy.wait_for_client()
print("Debugger attached.")

# Your code here

登录后复制

最后，在 VSCode 中点击 "Run and Debug" 按钮，选择 "Python: Remote Attach" 配置，即可开始远程调试。

远程开发遇到网络不稳定怎么办？

网络不稳定是远程开发中常见的问题。以下是一些应对网络不稳定情况的建议：

使用 Mosh： Mosh 是一个基于 UDP 的 SSH 替代方案，可以在网络不稳定的情况下提供更稳定的连接。Mosh 可以容忍网络延迟和丢包，即使在网络连接断开的情况下，也能保持连接状态。
使用 tmux 或 screen： tmux 和 screen 是终端复用器，可以在一个终端窗口中运行多个终端会话。即使网络连接断开，tmux 或 screen 会话也会保持运行，你可以重新连接后恢复会话。
使用 rsync： rsync 是一个文件同步工具，可以在本地机器和远程服务器之间同步文件。即使网络连接断开，rsync 也能在下次连接时继续同步。可以使用 rsync 定期备份远程服务器上的代码，以防止数据丢失。
配置 VSCode 自动保存： VSCode 的自动保存功能可以帮助你避免因网络连接断开而丢失代码。建议开启自动保存功能，并将保存间隔设置为较短的时间，例如 1 秒。
使用 Git 进行版本控制： 使用 Git 进行版本控制可以帮助你管理代码变更，并在网络连接断开的情况下恢复代码。建议定期提交代码到 Git 仓库，以防止数据丢失。

如何保证远程服务器的安全性？

远程服务器的安全性至关重要。以下是一些保证远程服务器安全性的建议：

使用 SSH 密钥： 使用 SSH 密钥可以避免每次连接都需要输入密码，提高安全性。
禁用密码登录： 禁用密码登录可以防止暴力破解。可以在
```
/etc/ssh/sshd_config
```
登录后复制
文件中设置
```
PasswordAuthentication no
```
登录后复制
来禁用密码登录。
使用防火墙： 使用防火墙可以限制对远程服务器的访问。可以使用
```
iptables
```
登录后复制
或
```
ufw
```
登录后复制
等防火墙工具。只允许必要的端口对外开放，例如 SSH 端口（默认是 22）。
定期更新系统和软件： 定期更新系统和软件可以修复安全漏洞。可以使用
```
apt update && apt upgrade
```
登录后复制
命令更新 Debian 或 Ubuntu 系统。
使用 Fail2ban： Fail2ban 可以监控系统日志，并在检测到恶意行为时自动阻止 IP 地址。例如，Fail2ban 可以监控 SSH 登录失败的次数，并在达到一定次数后阻止 IP 地址。
使用两因素认证： 使用两因素认证可以提高安全性。可以使用 Google Authenticator 或 Authy 等两因素认证工具。