Sublime Text插件必须用Python编写且类名须带Command后缀、文件名需匹配命令ID，否则Command Palette中不可见；edit对象仅在run()内有效一次，跨函数或回调重用将触发RuntimeError。
Sublime Text 插件必须用 Python 写，不是 JavaScript，也不能装 requests 这类第三方包——这是最常卡住人的起点。
为什么插件保存后 Command Palette 里搜不到
根本原因就两个：类名没带 Command 后缀，或文件名没对应上命令 ID。
- 类名必须是
CamelCaseCommand格式，比如InsertTimestampCommand，Sublime 才会把它注册为命令 - 命令 ID 自动转成小写下划线，
InsertTimestampCommand→insert_timestamp，所以你在Default (Windows).sublime-keymap里写绑定时，"command": "insert_timestamp"必须完全匹配 - 文件名建议和命令 ID 一致，比如
insert_timestamp.py，否则容易混淆；放在Packages/User/下最安全 - 改完代码后不重启 Sublime，按
Ctrl+Shift+P→ 输入Developer: Reload Plugin即可重载，但只对当前文件生效
为什么 view.insert(edit, 0, "text") 报 RuntimeError: Invalid edit object
edit 是一次性令牌，只在 run(self, edit) 方法体内有效，且只能用一次。任何跨函数、跨回调、缓存再用的操作都会崩。
- 错例：
self.cached_edit = edit然后在set_timeout回调里重用 → 直接报错 - 错例：
sublime.set_timeout(lambda: self.view.insert(edit, 0, "x"), 10)→edit已失效 - 正确做法：延迟操作前先把要插入的文本和位置算好，延时结束后调用
self.view.run_command('insert', {'characters': text})（推荐）；或者用self.view.replace(edit, region, text)在同一edit上批量操作 - 注意：ST4 不允许
view.begin_edit()，所以别试图手动重建edit
如何让插件响应快捷键或右键菜单
插件本身不写监听逻辑，全靠外部 JSON 配置驱动——这是 Sublime 的设计哲学，也是新手最容易忽略的环节。
立即学习“Python免费学习笔记（深入）”；
- 快捷键：编辑
Packages/User/Default (Windows).sublime-keymap（macOS/Linux 换对应文件名），加一条：{"keys": ["ctrl+alt+t"], "command": "insert_timestamp"} - 右键菜单：新建
Packages/User/Context.sublime-menu，内容为数组，每项含"caption"和"command"，例如：{"caption": "Insert Timestamp", "command": "insert_timestamp"} - 菜单栏：用
Main.sublime-menu，结构类似，但需注意层级嵌套规则 - 所有配置里的
command值，必须和插件类名去掉Command后缀、转成小写下划线的结果严格一致
真正难的不是写几行 Python，而是理解 Sublime 的“命令-配置分离”模型和 edit 的生命周期约束。这两个点踩错一个，插件就静默失败，控制台还不报明显错误。
