Sublime Text 插件是Python 3.8文件，需满足四条件：文件放Packages/User/下、类名CamelCaseCommand结尾、继承sublime_plugin.TextCommand或WindowCommand、定义run(self, edit)方法；否则无法在Command Palette中显示。
Sublime Text 插件不是 Node.js 脚本，也不是 TypeScript 项目，它就是一个 Python 3.8 文件（ST4），放在 Packages/User/ 下、类名以 Command 结尾、继承 sublime_plugin.TextCommand，就能立刻在 Command Palette 里搜到并运行。
怎么让插件出现在 Command Palette 里
Sublime 不扫描函数或裸类，只认“命名规范 + 继承关系”组合：
- 文件名任意，但建议小写加下划线，比如
insert_timestamp.py - 类名必须是
CamelCaseCommand格式，且以Command结尾，例如InsertTimestampCommand - 必须继承
sublime_plugin.TextCommand（文本操作）或sublime_plugin.WindowCommand（窗口级操作） - 类中必须定义
run(self, edit)方法，哪怕里面只写pass
满足以上四点，保存后按 Ctrl+Shift+P → 输入 “insert timestamp”，就能看到 “Insert Timestamp” 条目。不满足任一条件，命令就根本不会注册。
为什么 view.insert(edit, 0, "x") 突然报错 RuntimeError: Invalid edit object
这个错误几乎每个新手都会撞上——edit 是 Sublime 内部的一次性令牌，只在当前 run() 调用内有效，且只能用一次。
- 不能存成实例变量：
self.cached_edit = edit→ 后续调用必崩 - 不能传进
sublime.set_timeout回调：sublime.set_timeout(lambda: self.view.insert(edit, 0, "x"), 10)→ 错 - 不能在
run()返回后再用，哪怕只隔一行print("done") - 批量修改（如多次
insert或replace）必须复用同一个edit对象
如果真要异步插入（比如读完文件再写），得把内容先算好，然后用 self.view.run_command('insert', {'characters': text}) —— 这是跨上下文安全的间接方式。
如何绑定快捷键或右键菜单
插件本身不写快捷键，全靠外部 JSON 配置驱动。命令 ID 由类名自动推导：类名 ConvertToUppercaseCommand → 命令 ID 是 convert_to_uppercase（全部小写，驼峰处加下划线）。
- 快捷键：编辑
Packages/User/Default (Windows).sublime-keymap，添加项：{"keys": ["ctrl+alt+u"], "command": "convert_to_uppercase"} - 右键菜单：新建
Packages/User/Context.sublime-menu，内容为：[{"caption": "Convert to Uppercase", "command": "convert_to_uppercase"}] - 注意：命令名大小写必须完全匹配，
ConvertToUppercase和converttouppercase都无效
改完配置不用重启，保存即生效；插件代码改了则必须手动执行 Developer: Reload Plugin。
ST3 和 ST4 的 Python 版本差异真会影响代码
ST3 用 Python 3.3，ST4 升级到 Python 3.8，看似只是版本号变，实则直接影响语法可用性：
- ST3 不支持
f-string、pathlib.Path、yield from、海象运算符:= - ST4 支持
f-string和:=，但仍不支持import requests或任何 pip 安装的第三方包 - 所有插件都跑在 Sublime 自带的 Python 解释器里，没有
site-packages，也没有venv - 常见报错：
ImportError: No module named 'requests'、SyntaxError: invalid syntax（用了 f-string 却在 ST3 上运行）
如果你的目标用户可能还在用 ST3，就别用 f-string；如果只面向 ST4，可以放心用 := 简化逻辑——但千万别试图绕过限制去装包，这条路彻底堵死。
