Sublime Text本身不执行断点,调试依赖外部服务:Python需debugpy监听端口并正确配置路径与解释器;PHP需xdebug.mode=debug及精准path_mapping;JS断点在Sublime中完全无效,须用浏览器DevTools。

Sublime Text 本身不运行代码,也不执行断点;所谓“调试”,本质是配置外部调试服务 + 正确连接 + 路径映射。装完插件点红点 ≠ 能停住,没后端服务支撑,断点只是画了个圈。
Python 断点要生效,必须配 debugpy + Sublime Debugger
Sublime 的 F9 只是标记位置,真正停住靠的是 debugpy 进程监听并响应。缺一环就白点:
- 先运行
pip install debugpy(确保是项目所用 Python 环境) - 在项目根目录建
.sublime-debugger/config.json,内容里"args"必须含--listen 127.0.0.1:5678和--wait-for-client - Sublime Debugger 插件设置中,
python_path得指向真实解释器,比如C:Python311python.exe,不能只写python(Windows 常因此连不上) - 启动前用
netstat -ano | findstr :5678确认端口空闲,否则debugpy启动失败但 Sublime 不报错
PHP 断点不命中?90% 是 xdebug.mode 或 path_mapping 错了
点了红点、刷新页面没反应,不是插件问题,而是 PHP 进程根本没把调试请求发出来:
- 检查
php.ini是否真启用了xdebug.mode = debug(不是develop或注释掉) -
xdebug.client_port必须和 Sublime Xdebug Client 插件里设的端口一致(默认9003,不是旧版的9000) -
path_mapping是硬伤:如果服务器路径是/var/www/html,而你本地在D:projectwww,就必须配成{"/var/www/html": "D:\project\www"}(Windows 反斜杠要双写) - 浏览器必须装
Xdebug Helper扩展,并点击虫子图标激活——xdebug.start_with_request = trigger不是自动开,是“等你点”
JavaScript 在 Sublime 里设断点纯属无效操作
这不是配置不到位,是架构上不可能:Sublime 没 JS 引擎,F9 红点对 Chrome DevTools 或 node --inspect 完全无感知。
- 正确做法是:在 Sublime 写好
console.log或debugger;,保存后切到 Chrome → F12 → Sources 面板,找到对应文件手动打点 - 别装 Sublime 的 Debugger 类插件试图连 Chrome——2026 年实测命中率低、变量面板常为空、F11 单步容易卡死
- 想热更新?用
Live Server扩展或browser-sync,它们管刷新,Sublime 只管保存
安装插件前,先确认 Package Control 能正常工作
很多“插件装不上”“点了没反应”的问题,根源是 Package Control 自身没装稳:
- 按
Ctrl + `调出控制台,粘贴官方脚本(2026 年仍有效),看到reloading settings Packages/User/Package Control.sublime-settings才算成功 - 重启 Sublime 后,左下角应出现
Package Control提示,否则后续所有Ctrl+Shift+P → Install Package都会静默失败 - 如果控制台报
ssl.SSLCertVerificationError,说明网络受限,得手动下载Package Control.sublime-package放进Installed Packages目录再重启
最易被忽略的一点:所有调试配置都依赖「路径绝对准确」和「端口不冲突」,而不是插件数量或 UI 多炫。一个错位的 path_mapping 或一个被占用的 5678 端口,就能让整个调试流程静默失效,且几乎不报错。

















