Sublime Text中调试代码的插件有哪些？如何设置其调试环境？

本文共计1150个文字，预计阅读时间需要5分钟。

Sublime Text 本身不带调试功能，所有断点调试功能都依赖外部工具。

---

Debugger 插件是当前唯一靠谱的选择

截至 2026 年中，Debugger（rprichard 维护，图标是蓝色靶心）是 Sublime 上唯一全面支持 DAP 协议、稳定兼容 Python/PHP/Go/Node.js 的调试插件。老插件如 SublimeXdebug 已停止更新，对 Xdebug 3.x 和 PHP 8.2+ 支持极差；SublimeREPL 只能跑脚本看输出，不能设断点、单步或查变量。

• 安装必须用 Package Control: Install Package → 搜 Debugger（不是 “SublimeDebugger” 或 “Xdebug Client”）
• 装完菜单栏出现 Debug 项，状态栏右下角无 Debugger: xxx 提示，说明配置文件没加载成功
• 它不读 launch.json，只认项目根目录下的 .sublime-debugger（注意开头有个点，是隐藏文件）
• 配置顶层必须是 "configurations": [] 数组，每个对象至少含 "type"、"request"、"name"

---

Python 调试必须配对 debugpy==1.6.7

新版 debugpy>=1.8 默认启用新握手协议，而当前 Debugger 插件（4147 版）仍依赖旧版 DAP 流程，直接导致“F5 按下没反应”或日志报 Protocol mismatch。

• 终端执行：pip install debugpy==1.6.7（Python 3.8+ 推荐）
• .sublime-debugger 中必须显式写 "python": "/usr/bin/python3"（macOS/Linux）或 "python": "C:\Python39\python.exe"（Windows），不能只写 "python": "python"
• "program": "${file}" 和 "cwd": "${fileDirname}" 必须同时存在，否则相对导入失败、配置文件读不到
• virtualenv 环境下，python 字段必须填激活后的绝对路径，比如 ~/venv/bin/python

---

PHP 调试卡住？八成是 xdebug.mode 或 pathMappings 错了

Sublime 不主动连 PHP，它只是监听端口等 Xdebug 主动反向连接。断点灰色、F5 按下无响应、状态栏不显示 Debugger: PHP，基本都是这两处出问题。

• Xdebug 3.x 必须设 xdebug.mode=debug（不是 xdebug.remote_enable=1），旧配置会被完全忽略
• xdebug.client_port=9003 是默认值，.sublime-debugger 中的 "port": 9003 必须与之一致
• "pathMappings" 左边填 PHP 实际运行路径（如 Docker 容器内是 /var/www/html/，就填这个），右边填 Sublime 项目根目录（用 ${folder}）
• Windows 用户注意：路径分隔符必须用 / 或 \，单反斜杠 会导致 JSON 解析静默失败
• 浏览器访问时必须触发 Xdebug，比如加 ?XDEBUG_SESSION_START=1 或用 Xdebug Helper 插件

---

JavaScript 前端调试只能靠浏览器 DevTools 配合

Sublime 没有 JS 引擎，Debugger 插件对前端 JS 的支持本质是“转发到 Chrome/Edge”，不是真正在 Sublime 里跑 V8。你设的断点最终由浏览器处理，Sublime 只同步 UI。

• 不要指望在 Sublime 里看 console.log 输出并点击跳转——那是 VS Code 的功能，Sublime 不做日志捕获
• 推荐工作流：Live Server 插件自动刷新 + 在代码里写 debugger; + 切到 Chrome DevTools 的 Sources 面板按 F8 继续
• 如果要用 Debugger 插件连浏览器，.sublime-debugger 中 "type" 填 chrome 或 edge，但需提前启动浏览器带远程调试端口：chrome --remote-debugging-port=9222
• Webpack/Vite 构建项目要注意 sourcemaps 路径是否正确，否则断点打不到原始 .ts 或 .jsx 文件

真正容易被忽略的是：Sublime 启动方式决定它能不能读到你的环境变量。从 Dock 或开始菜单点开的 Sublime，根本看不到终端里 export PATH 或 ~/.zshrc 里的配置。必须用终端执行 subl . 打开项目，否则 python 找不到、php 加载错 php.ini、debugpy 版本不匹配——全都会静默失败。