如何配置VS Code以进行远程服务器代码调试-VSCode-PHP中文网

如何配置VS Code以进行远程服务器代码调试

P粉986688829

发布： 2025-12-03 20:03:06

原创

211人浏览过

<ol><li>安装Remote - SSH扩展并配置SSH主机信息，通过命令面板添加主机连接；2. 成功连接后在远程服务器打开项目文件夹；3. 在项目根目录创建launch.json配置调试环境，如Python或Node.js的调试参数；4. 确保远程服务器满足条件并自动安装VS Code Server，必要时手动安装语言调试依赖，即可实现断点调试与变量查看等本地化开发体验。</li></ol>

如何配置vs code以进行远程服务器代码调试

在 VS Code 中配置远程服务器代码调试，主要依赖于 Remote - SSH 扩展。通过它可以直接连接到远程服务器，在远程环境中编辑和调试代码，就像操作本地文件一样流畅。

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

打开 VS Code，进入扩展市场（快捷键 Ctrl+Shift+X），搜索 Remote - SSH 并安装。这是微软官方提供的远程开发工具。

安装完成后，在左侧活动栏点击“远程资源管理器”图标，或使用快捷键 Ctrl+Shift+P 打开命令面板，输入 Remote-SSH: Connect to Host... 开始配置连接。

你需要配置 SSH 主机信息：

在命令面板中选择 Remote-SSH: Add New SSH Host
输入连接命令，例如：ssh username@server_ip -p port
选择保存到哪个 SSH 配置文件（通常是 ~/.ssh/config）
之后可在远程资源管理器中看到该主机，点击即可连接

2. 连接远程服务器并打开项目

成功连接后，VS Code 会启动一个远程会话，界面左下角显示当前连接的主机名。

点击“打开文件夹”，选择服务器上的项目路径，例如：/home/username/myproject。VS Code 会在远程上下文中加载项目，所有文件操作都在服务器上进行。

3. 配置调试环境（launch.json）

调试前需在项目根目录下创建 .vscode/launch.json 文件，定义调试配置。

以 Python 为例：

Eclipse中创建Web Maven Project并部署到Tomcat中中文WORD版

大家都知道，在进行J2EE项目的开发过程中，在调试阶段如果只是修改了页面是不需要重启应用服务器的，比如不需要重启Tomcat。只需要在浏览器中进行页面刷新即可。其实之所以不用重启Tomcat等应用服务器，其根本原因是因为我们可以在应用服务器的配置文件中设置虚拟目录，这样就可以知道web 项目所在的目录，于是就可以省去打包、然后再重新发布到服务器的步骤。感兴趣的朋友可以过来看看

查看详情

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Python: Remote Debug",
      "type": "python",
      "request": "launch",
      "program": "${workspaceFolder}/main.py",
      "console": "integratedTerminal",
      "justMyCode": true
    }
  ]
}

登录后复制

如果是 Node.js 项目：

{
  "name": "Node: Attach to Remote",
  "type": "node",
  "request": "attach",
  "port": 9229,
  "address": "localhost",
  "localRoot": "${workspaceFolder}",
  "remoteRoot": "/home/username/myproject"
}

登录后复制

确保远程服务已启用调试模式（如 Node.js 启动时加 --inspect=0.0.0.0:9229）。