确认插件正在运行且有输出，需打开sublime控制台（view → show console或ctrl+`），查看import错误、语法错误、print()输出及异常堆栈；插件须存于packages/user/下、文件名以.py结尾、类继承textcommand/windowcommand，避免__init__阻塞逻辑。
怎么确认插件正在运行且有输出
Sublime 的自定义插件本质是 Python 模块，加载失败或静默退出时根本不会报错，你只会发现快捷键没反应、命令面板搜不到、或者右键菜单缺项——这是最常被当成“调试失败”的假象。
真正该先做的，是打开 Sublime 控制台（View → Show Console 或 Ctrl+`），它会实时打印 import 错误、语法错误、print() 输出和异常堆栈。所有插件调试的起点都在这里。
- 插件文件必须保存在
Packages/User/目录下（可通过Preferences → Browse Packages…进入），放错位置（比如直接丢进Packages/根目录）会导致完全不加载 - 文件名必须是
.py结尾，且类名需继承sublime_plugin.TextCommand或sublime_plugin.WindowCommand，名字不匹配就注册失败 - 避免在
__init__里写阻塞逻辑（如网络请求、大文件读取），它会在插件加载时同步执行，卡住整个 UI - 用
print("debug:", vars)替代logging，控制台只认print；重启 Sublime 后控制台清空，记得留好关键日志
为什么断点调试在 Sublime 插件里基本不可行
因为 Sublime Text 自身没有暴露调试协议，Debugger 插件（蓝色靶心图标）不支持 Python 插件调试场景——它只对接外部语言服务器（如 pylsp）或解释器进程（如独立运行的 python script.py），而 Sublime 插件是直接嵌入主进程的 Python 子解释器，无法 attach。
你设的断点永远不会停，pdb.set_trace() 会直接抛出 RuntimeError: lost sys.stdout，不是你的代码问题，是环境限制。
- 唯一可行的“单步”方式：用
print()+sublime.status_message()把关键变量推到状态栏，肉眼追踪流程 - 如果非要观察对象结构，用
import pprint; pprint.pprint(obj)，比原始print更安全（避免不可序列化对象崩溃） - 别尝试把插件改成独立脚本去 debug——路径、API（如
sublime.active_window()）全失效，脱离上下文毫无意义
如何模拟真实触发场景做功能验证
插件行为高度依赖触发时机和上下文：菜单点击、快捷键、保存事件、视图焦点变化……直接运行 .py 文件等于白试。必须让它在 Sublime 真实生命周期里跑起来。
- 给命令绑定快捷键是最稳的测试通路：在
Preferences → Key Bindings用户设置里加一行，例如：{ "keys": ["ctrl+alt+p"], "command": "insert_datetime" }，然后按组合键看是否生效 - 检查命令名是否拼错：
InsertDatetimeCommand类对应命令是insert_datetime（小写下划线，去掉Command后缀），大小写/符号错一位就找不到 - 监听事件（如
on_post_save）要确保插件类继承sublime_plugin.EventListener，且文件名和类名在同一个文件里，不能拆开 - 用
sublime.active_window().active_view().file_name()确认当前是否真有打开的文件，很多插件崩溃是因为假设了文件一定存在
常见报错和对应修复动作
控制台里反复出现的几类错误，基本对应固定原因，不用猜：
-
ImportError: No module named 'xxx'：说明用了第三方包（如requests）。Sublime 自带的 Python 环境不包含 pip，不能装；要么纯 stdlib 实现，要么用urllib替代 -
AttributeError: 'NoneType' object has no attribute 'xxx'：典型是sublime.active_window()或view.sel()返回None，必须加判空，例如if view and view.is_valid(): -
TypeError: expected str, bytes or os.PathLike object, not NoneType：多出现在view.file_name()为None（新建未保存标签页）时直接传给os.path函数，同样要提前检查 - 控制台空白但插件无响应：90% 是文件没保存（.py 文件必须保存才加载）、或保存后没重启 Sublime（改完代码必须重启才能重载模块）
插件调试不是写业务逻辑，核心就三件事：盯住控制台、用 print 替代断点、每次改完都重启。所有绕开这三点的方案，最后都会绕回来。
