Sublime Text插件开发核心是事件驱动+命令注册+视图交互，需继承TextCommand/WindowCommand并重写run方法，通过edit对象安全修改文本，用ViewEventListener监听事件，调试依赖status_message和控制台输出。
Sublime Text 的 Python API 是插件开发的核心，它让你能直接操作编辑器的视图、窗口、设置、命令等。入门的关键不是学完所有 API，而是先跑通一个最小插件，理解“事件驱动 + 命令注册 + 视图交互”这个主线。
从一个 .py 文件开始
Sublime 插件本质就是 Python 脚本，放在 Packages/User/ 目录下（可通过 Preferences → Browse Packages… 打开）。文件名决定命令名：比如 hello_world.py 会自动注册一个 hello_world 命令。
- 每个插件至少要继承
sublime_plugin.TextCommand（作用于当前视图）或sublime_plugin.WindowCommand（作用于当前窗口） -
run(self, edit)是必重写的方法，edit对象是文本修改的唯一合法入口 - 别直接用
view.replace()或view.insert()，必须传入edit
快速写个可运行的插件
在 Packages/User/hello_world.py 中写：
import sublime
import sublime_plugin
class HelloWorldCommand(sublime_plugin.TextCommand):
def run(self, edit):
self.view.insert(edit, 0, "Hello from Sublime API!\n")
保存后，按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 hello world，回车即可执行——文本就插入到光标位置（第 0 行开头）。
立即学习“Python免费学习笔记（深入）”；
-
self.view指当前活动视图；edit是 Sublime 管理的编辑上下文，生命周期只在run()内有效 - 想获取选中文本？用
self.view.substr(self.view.sel()[0]) - 想替换选中内容？用
self.view.replace(edit, self.view.sel()[0], "new text")
监听事件：让插件“活”起来
纯命令是手动触发的，而事件监听器（如 ViewEventListener）能响应保存、激活、修改等动作。
- 新建 Packages/User/auto_title.py，监听文件保存时自动加时间戳
- 继承
sublime_plugin.ViewEventListener，重写on_pre_save() - 注意：不能在事件方法里调用
view.insert()等修改操作（可能冲突），应改用set_timeout()延迟执行
调试不靠 print，靠 sublime.status_message() 和控制台
Sublime 不支持传统 print 调试。常用技巧：
-
sublime.status_message("debug: x = {}".format(x))把信息临时显示在状态栏 -
print()输出到 Sublime 控制台（Ctrl+` 或 View → Show Console） - 插件报错时，控制台会显示完整 traceback，重点关注行号和异常类型（如
AttributeError多因 view 已关闭）
基本上就这些。不需要背 API 文档，先改几个现成插件（比如 GitHub 上的 SideBarEnhancements 或 BracketHighlighter），看它们怎么读配置、怎么绑定快捷键、怎么响应鼠标点击——边抄边懂，比从头学文档快得多。
