Debugger插件必须安装才能断点调试，它依赖外部调试适配器，仅提供图形界面和协议桥接；轻量运行用SublimeREPL或Build System即可。
Debugger插件到底装不装得动？先看你的语言和需求
Sublime Text 原生不带调试器，Debugger 插件是目前最主流、支持最广的断点调试方案，但它不是“万能IDE替代品”——它依赖外部调试适配器（比如 python、dlv、xdebug），只负责图形界面和协议桥接。如果你只是想快速运行脚本看输出，装 SublimeREPL 或配个 Build System 更轻量；但真要设断点、单步、看变量，Debugger 是绕不开的选择。
安装 Debugger：别被 Package Control 卡在第一步
按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（Mac）调出命令面板，输入 Package Control: Install Package 回车，等列表加载完再搜 Debugger ——注意不是 “SublimeDebugger” 或 “Xdebug Client”，而是由 rprichard 维护的官方 Debugger（图标是蓝色靶心）。安装后菜单栏会多出 Debug 项，如果没出现，重启 Sublime 再试一次；常见失败原因是 Package Control 本身没装好，可先用控制台执行安装脚本验证。
配置 launch.json：${file} 和 cwd 错一位，断点就全失效
点击 Tools → Debugger → Open Launch Configurations，选当前项目生成 .sublime-project 里的调试配置。Python 最简可用配置如下：
{
"configurations": [
{
"type": "python",
"request": "launch",
"name": "Debug Python File",
"program": "${file}",
"console": "integrated",
"cwd": "${fileDirname}",
"env": {}
}
]
}
关键点：program 必须是 "${file}"（当前文件路径），不能写成 "$file" 或漏掉引号；cwd 必须设为 "${fileDirname}"，否则相对导入、读取本地配置文件会报 ModuleNotFoundError 或 FileNotFoundError。Go/PHP 同理，program 要对应入口文件，pathMappings 必须严格匹配服务器路径与本地路径。
断点能设但不停？检查解释器、端口、启动模式三座大山
- Python：终端里跑
python --version确认可用；若提示“找不到解释器”，在配置中显式加"python": "/usr/bin/python3"或 Windows 下的完整路径 - PHP：
xdebug.mode=debug必须开启，xdebug.client_port=9003要和launch.json中的port一致；浏览器访问时需触发 Xdebug（如加?XDEBUG_SESSION_START=1或用浏览器插件） - Go：
dlv必须已安装且路径正确，LSP-Debugger 设置里要指向$GOPATH/bin/dlv；mode: "debug"不能写成"test"或漏掉
所有语言共通陷阱：断点设在注释行、空行、函数定义行（而非可执行语句）时不会命中；多线程、异步回调、信号处理等场景，Debugger 无法暂停或变量显示不全——这不是配置问题，是能力边界。
