windowcommand 是 sublime text 中响应窗口级操作的插件类，继承自 sublime_plugin.windowcommand，适用于需操作窗口（如新建标签、调用面板）而非仅编辑文本的场景。
WindowCommand 是什么，什么时候该写它
WindowCommand 是 Sublime Text 插件中用于响应「窗口级」操作的 Python 类，继承自 sublime_plugin.WindowCommand。它和 TextCommand 的关键区别在于：前者能访问整个 window 对象（比如打开新标签页、切换面板、调用菜单命令），后者只能操作当前视图（view）里的文本。
你该写 WindowCommand 的典型场景包括：
- 想从 Command Palette 运行一个不依赖光标位置的操作（如“新建终端”“聚焦侧边栏”）
- 需要操作多个视图或新建视图（如批量重命名打开的文件）
- 要调用
window.run_command()执行内置命令（比如window.run_command('show_panel', {'panel': 'console'})） - 命令逻辑需要读取或修改窗口状态（如当前是否在项目中、有多少个组）
最简可用的 WindowCommand 文件结构
Sublime 插件必须放在 Packages 目录下，且文件名和类名需遵循命名规范。一个最小但可运行的 WindowCommand 示例：
import sublime
import sublime_plugin
<p>class MyExampleCommand(sublime_plugin.WindowCommand):
def run(self):
self.window.status_message("Hello from WindowCommand!")</p>
注意几个硬性要求：
- 文件名必须是小写加下划线，如
my_example.py（对应命令名my_example） - 类名必须以
Command结尾，且采用 PascalCase，如MyExampleCommand - 类必须继承
sublime_plugin.WindowCommand -
run()方法是必选入口，无参数时 Sublime 会直接调用它
如果类名写成 MyExample 或文件名是 MyExample.py，插件加载失败，且不会报错——只会默默忽略。
如何传参并安全使用 window 对象
WindowCommand.run() 支持接收任意关键字参数，常用于从 key bindings 或 menu 中传入配置：
# 在 .sublime-keymap 中绑定：
{ "keys": ["ctrl+alt+x"], "command": "my_example", "args": {"mode": "debug"} }
对应代码中这样读取：
def run(self, mode="normal"):
if mode == "debug":
print("Debug mode enabled")
self.window.status_message(f"Mode: {mode}")
关键注意事项：
-
self.window在run()执行期间一定有效，但不要缓存它（比如赋值给实例变量），因为窗口可能被关闭，后续访问会引发AttributeError - 不要在
run()外部（如<strong>init</strong>）访问self.window—— Sublime 不保证此时window已就绪 - 如果命令需要异步行为（如等待用户输入），用
self.window.show_input_panel()等回调式 API，别用阻塞式轮询
调试失败时先查这三处
WindowCommand 加载失败通常无声无息，排查优先看：
- 控制台（
Ctrl+`）是否有ImportError或语法错误（比如漏了冒号、缩进错） - 命令名是否拼写一致：Python 类名
MyExampleCommand→ 命令调用名是my_example（自动 snake_case 转换），不是my_example_command - 是否误用了
sublime_plugin.TextCommand基类却想调用self.window—— 这会直接抛AttributeError: 'MyExampleCommand' object has no attribute 'window'
真正容易被忽略的是：Sublime 在插件加载阶段不会校验 WindowCommand 类是否真的定义了 run() 方法。如果手误写成 Run() 或 runn()，控制台完全不报错，命令就是“不存在”。
