sublime text 本身无调试功能，所有断点调试均依赖外部工具（如debugpy、xdebug、浏览器devtools）和debugger插件桥接；该插件是截至2026年中唯一全面支持dap协议、兼容多语言的稳定方案，需配.sublime-debugger文件、匹配debugpy 1.6.7、指定python绝对路径及正确pathmappings。
Sublime Text 本身不带调试能力，所有“断点调试”功能都依赖外部工具 + 插件桥接。真正起作用的不是 Sublime，而是你本地装的 debugpy、xdebug、dlv 或浏览器 DevTools——Sublime 只是把它们的界面和协议封装成可操作的面板。
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 版本不匹配——全都会静默失败。
