输入 set syntax: python 无反应是因为文件未被识别为可绑定语法的上下文，常见于无扩展名、未保存或后缀被忽略的文件；go to symbol in file（@）只匹配符号定义，ctrl+r 是全文字符串匹配；package control 需先安装再使用；自定义命令必须存于 packages/user/ 下且符合 json 结构与命名规范。
为什么输入 Set Syntax: Python 有时没反应？
不是命令错了，而是文件本身没被 Sublime 识别为可绑定语法的上下文。常见于无扩展名文件（如 foo）、临时粘贴新建的未保存文档，或后缀被忽略（比如 .env 默认当 Plain Text）。
此时命令面板里输 Set Syntax: Python 会搜不到选项，甚至直接跳过。
实操建议：
• 先按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Revert File to Saved 回车——强制刷新当前文件状态
• 或手动执行 View → Syntax → Open all with current extension as…，选一次 Python，后续同后缀文件自动生效
• 若是无后缀文件，保存为 .py 后再试；也可临时用 View → Syntax → Python 点选（不依赖命令面板）
Go to Symbol in File 和 Ctrl+R 有什么本质区别？
Ctrl+R 是全文字符串匹配，而 Go to Symbol in File（命令面板输入该名或直接按 @ 前缀）只扫描符号定义：函数、类、方法、变量声明等 AST 级节点，不匹配注释、字符串字面量或普通文本。
使用场景：
• 大文件里找 __init__，Ctrl+R 可能刷出几十个无关的 “init” 字符串；@init 则只列构造函数和初始化方法
• 输入 @render 能精准跳到 def render(self):，不会命中 self.rendered = True
• 不支持正则，但支持驼峰缩写：输 @gss 可匹配 get_selected_symbol
如何让 Package Control: Install Package 真正可用？
它不是“点一下就装”，而是一个两阶段流程：先确保 Package Control 存在，再调用其安装逻辑。很多用户卡在第一阶段，却以为是网络或插件源问题。
实操建议：
• 按 Ctrl+Shift+P，输入 install package control（完整短语，含空格），回车——这是唯一触发自动下载安装的入口
• 安装成功后，重启 Sublime（非必须，但推荐），再输 Package Control: Install Package 才会列出包列表
• 若仍无响应，检查 Preferences → Package Settings → Package Control → Settings – User 中是否有 "channels" 配置，删掉异常 URL 或恢复默认值
• 注意：所有后续包安装都是本地缓存 + 异步加载，输入命令后不必等待“加载中”提示，直接输包名回车即可
自定义命令为什么在命令面板里搜不到？
Sublime 不会自动扫描任意 JSON 文件。自定义命令必须放在正确路径的正确格式文件里，且文件名后缀、顶层结构、caption 字段都需严格匹配。
关键条件：
• 文件必须保存在 Packages/User/ 目录下，命名为 xxx.sublime-commands（如 header.sublime-commands）
• 内容必须是数组，每个对象含 "caption"（显示名）、"command"（命令名）、"args"（可选）
• caption 值要包含至少两个字符，且不能纯数字或空格开头
• 示例有效内容：
[{"caption": "Insert Header", "command": "insert_snippet", "args": {"contents": "# Created by ${user} on ${date}\n"}}]
• 修改后无需重启，但若命令名拼错（如把
insert_snippet 写成 insert_snipet），命令面板会静默忽略整条命令面板的模糊匹配很宽容，但背后每个命令都有硬性约束。最常被忽略的是路径位置和 JSON 结构合法性——不是“写了就能用”，而是“写对了才出现”。
