首页 > 开发工具 > VSCode > 正文

使用VS Code的远程调试功能调试服务器上的代码

P粉986688829
发布: 2025-12-04 20:33:28
原创
964人浏览过
VS Code远程调试通过本地编辑器连接远程调试代理实现,需安装对应语言调试器(如Python用debugpy)、开放端口并正确配置launch.json的host、pathMappings等参数。

使用vs code的远程调试功能调试服务器上的代码

VS Code 的远程调试功能可以让你在本地编辑代码,同时直接调试运行在远程服务器(比如 Linux 服务器、Docker 容器或 WSL)上的程序。关键不是“把代码拷到本地”,而是让 VS Code 的调试器与远程环境中的调试代理(如 ptvsddebugpynode --inspect 等)通信。

确保远程环境已安装对应语言的调试支持

不同语言需要不同的调试适配器。例如:

  • Python:推荐使用 debugpy(微软官方维护,替代已停更的 ptvsd
  • Node.js:内置 --inspect 模式,无需额外安装
  • Go / Java / C#:需安装对应扩展并配置远程调试代理(如 dlvjdwpdotnet-dbg

以 Python 为例,在远程服务器上执行:
pip install debugpy
确认安装成功后,可通过 python -m debugpy --help 验证。

启动远程调试服务并开放端口

让目标程序以调试模式启动,并监听一个可被本地 VS Code 访问的端口(默认通常是 5678)。注意:该端口需在远程服务器防火墙/安全组中放行,且绑定地址建议用 0.0.0.0(而非 127.0.0.1),否则本地连不上。

例如 Python 调试启动命令:

python -m debugpy --listen 0.0.0.0:5678 --wait-for-client your_script.py

其中 --wait-for-client 表示启动后暂停,等 VS Code 连接后再继续执行,便于打断点。

在本地 VS Code 中配置 launch.json

打开项目文件夹(可以是空文件夹,只要能访问源码),按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入 Debug: Open launch.json,选择对应环境(如 Python),然后修改配置:

某地板超炫企业网站1.1
某地板超炫企业网站1.1

1、演示:以截图为准 2、程序说明 程序试用后台:http://你的域名/admin/login.asp 后台登陆帐号:admin 密码:admin123 说明: 这个是基于asp+access的企业网站源码,数据库已设有有防下载,网站更安全 要修改网站,自定义你自己要的页面,和美化页面都是你自己完成,网站源码程序完整,后台功能强大。 调试运行环境:要安装IIS服务器(IIS的安装和配置,安装好

某地板超炫企业网站1.1 0
查看详情 某地板超炫企业网站1.1
{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Python: Remote Attach",
      "type": "python",
      "request": "attach",
      "connect": {
        "host": "your-server-ip",
        "port": 5678
      },
      "pathMappings": [
        {
          "localRoot": "${workspaceFolder}",
          "remoteRoot": "/path/on/server"  // 远程脚本实际所在路径
        }
      ]
    }
  ]
}
登录后复制

重点检查三项:

  • host:填服务器公网或内网 IP(不是 localhost
  • remoteRootlocalRoot 必须一一对应,否则断点无法命中(路径大小写、斜杠方向、软链接都可能影响)
  • 确保本地有和远程一致的源码(不需要完全同步,但设断点的文件必须存在且内容匹配)

连接调试并验证

在本地 VS Code 中设置好断点,按 F5 启动调试(选择刚配置的 Python: Remote Attach),如果看到调试工具栏出现、变量窗可读取、程序在断点暂停,说明成功。

常见失败原因:

  • 端口不通(telnet your-server-ip 5678 测试)
  • 路径映射错误(remoteRoot 多了 /home/user 或少了 /app
  • 远程调试进程未启动,或已退出
  • 本地代码版本和远程不一致(改了但没同步,或用了 git checkout 切分支)

基本上就这些。不复杂但容易忽略细节,尤其是路径和端口绑定方式。

以上就是使用VS Code的远程调试功能调试服务器上的代码的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号