<p>答案是通过安装Remote – ssh扩展并配置SSH连接,可在vscode中直接远程调试服务器代码。首先安装Remote – SSH扩展,确保本地能通过SSH免密登录服务器;接着在VSCode中添加SSH主机配置,连接后打开服务器项目文件夹;然后在项目根目录创建.vscode/launch.json文件,根据语言设置调试参数,如python或node.js;最后像本地一样设断点并启动调试,VSCode将在远程服务器上运行程序并支持变量查看、调用栈分析等操作,实现高效流畅的远程开发调试体验。</p>

要使用 VSCode 调试服务器上的代码,核心方法是通过 Remote – SSH 扩展实现远程开发和调试。你不需要把代码下载到本地,可以直接在服务器上编辑、运行和调试,就像操作本地项目一样。
1. 安装 Remote – SSH 扩展
VSCode 本身不支持直接连接远程服务器,需要安装官方扩展:
- 打开 VSCode,进入扩展商店(快捷键 Ctrl+Shift+X)
- 搜索 Remote – SSH
- 安装由 microsoft 发布的这个扩展
2. 配置 SSH 连接
确保你的本地机器可以通过 SSH 连接到目标服务器。
- 本地生成 SSH 密钥(如未生成):运行 ssh-keygen,并将公钥(~/.ssh/id_rsa.pub)添加到服务器的 ~/.ssh/authorized_keys
- 测试连接:ssh username@server_ip,能免密登录最佳
- 在 VSCode 左侧活动栏点击“远程资源管理器”图标(或按 Ctrl+Shift+P)
- 输入命令:Remote-SSH: Connect to Host…
- 选择 Add New SSH Host,输入:ssh username@server_ip
- 选择 SSH 配置文件(通常是 ~/.ssh/config)保存配置
3. 远程打开项目并设置调试环境
连接成功后,VSCode 界面会切换为远程工作区。
例如,调试 Python 脚本的 launch.json 示例:
{ “version”: “0.2.0”, “configurations”: [ { “name”: “Python: Remote Script”, “type”: “python“, “request”: “launch”, “program”: “${workspaceFolder}/app.py”, “console”: “integratedTerminal” } ] }
如果是 node.js,将 type 改为 “node“,其他语言同理。
4. 开始调试
一切就绪后,操作与本地完全一致:
- 在代码中打上断点
- 点击右上角的“运行和调试”按钮,或按 F5
- VSCode 会在远程服务器上启动程序,并在断点处暂停
- 你可以查看变量、调用栈、控制台输出等
基本上就这些。只要 SSH 通了,VSCode 的远程调试体验非常流畅,适合开发部署在云服务器、docker 容器或内网机器上的应用。关键是配置好 SSH 免密登录和正确的 launch.json。