安装sublime text并配置package control是使用插件和搜索功能的前提；需按平台差异安装，执行控制台脚本后重启才能启用命令面板与插件管理；文件搜索依赖项目模式（ctrl+shift+r/cmd+shift+r）且需手动刷新索引；内容搜索需在where中填“.”或指定路径；fuzzyfilepath插件优化路径补全，但需配置excluded_dirs和root_path。
安装 Sublime Text 和 Package Control 是前提
没装 Package Control，后续所有插件和搜索优化都无从谈起。Windows/macOS/Linux 三端安装方式略有差异，但核心动作一致：下载官方安装包（sublimetext.com/3），运行后勾选“添加到右键菜单”（Windows）或拖入 Applications（macOS）。Linux 用户推荐用 APT 源安装，避免手动解压路径混乱。
安装完立刻打开 Sublime Text，按 Ctrl+`（反引号）调出控制台，粘贴官网最新安装脚本（2026 年仍有效），回车执行。成功后会提示重启——不重启，Ctrl+Shift+P 打不开命令面板，Install Package 就不存在。
常见卡点：
- 控制台报错
urllib.error.URLError：大概率是公司网络拦截了packagecontrol.io，换代理或手动下载Package Control.sublime-package放进Packages/目录 - 重启后
Preferences → Package Control菜单项没出现：说明脚本没执行成功，别跳过控制台输出，看最后一行是不是restarting或error
文件名搜索必须走项目模式，不是 Ctrl+P 就万事大吉
Ctrl+P（Win/Linux）或 Cmd+P（macOS）搜不到文件？不是快捷键坏了，而是 Sublime 根本没在“搜文件”，它只在已打开的标签页里做模糊匹配。真正能扫磁盘文件的，只有项目模式下的 Ctrl+Shift+R（Win/Linux）或 Cmd+Shift+R（macOS）。
三个硬性条件缺一不可：
- 必须通过
Project → Add Folder to Project加载整个目录树，单文件打开状态无效 - 右下角状态栏必须显示类似
~/my-project/的路径，否则索引不启动 - 新增文件后要手动
Ctrl+Shift+P → Refresh Folders，索引不是实时更新的
输关键词时别指望完整拼写：api*util*.py 可以匹配 api_utils.py，但 api.*util.*\.py 会失败——通配符只支持 *，不支持正则。
内容搜索（Ctrl+Shift+F）的 Where 填错等于白搜
Ctrl+Shift+F 默认只查“已打开且已保存”的文件内容，想搜整个项目，Where 输入框必须填 .（一个英文点），不是空着、不是 ./、更不是 src（漏掉斜杠就只搜当前目录）。
高效范围控制示例：
- 只搜
src/下所有文件（含子目录）：src/ - 排除
node_modules和dist：., -node_modules/, -dist/ - 限定类型（支持 glob）：
src/**/*.ts,src/**/*.tsx - 搜未保存但已打开的文件：
open_files
中文搜索前务必确认右下角编码是 UTF-8，否则正则 \b函数名\b 会错位匹配；搜函数定义建议用 ^\s*def\s+render\b 这类行首锚定表达式，Where 填 *.py 限定范围。
FuzzyFilePath 插件让路径补全不再靠猜
写 import './components/ 或 <img src="assets/%20%E6%97%B6%EF%BC%8C%E6%8C%89%20Tab%20%E5%B0%B1%E5%BC%B9%E5%87%BA%E5%8C%B9%E9%85%8D%E6%96%87%E4%BB%B6%E5%88%97%E8%A1%A8%E2%80%94%E2%80%94%E8%BF%99%E5%B0%B1%E6%98%AF%20FuzzyFilePath%20%E7%9A%84%E4%BD%9C%E7%94%A8%E3%80%82%E5%AE%83%E4%B8%8D%E6%94%B9%E5%8F%98%E6%90%9C%E7%B4%A2%E9%80%BB%E8%BE%91%EF%BC%8C%E4%BD%86%E6%8A%8A%E6%A8%A1%E7%B3%8A%E5%8C%B9%E9%85%8D%E4%BB%8E%E2%80%9C%E6%89%BE%E6%96%87%E4%BB%B6%E2%80%9D%E4%B8%8B%E6%B2%89%E5%88%B0%E2%80%9C%E5%86%99%E8%B7%AF%E5%BE%84%E2%80%9D%E8%BF%99%E4%B8%80%E5%85%B7%E4%BD%93%E5%8A%A8%E4%BD%9C%E9%87%8C%E3%80%82
%E5%AE%89%E8%A3%85%E5%90%8E%E9%BB%98%E8%AE%A4%E7%94%9F%E6%95%88%EF%BC%8C%E4%BD%86%E5%AE%B9%E6%98%93%E8%A2%AB%E5%BF%BD%E7%95%A5%E7%9A%84%E9%85%8D%E7%BD%AE%E9%A1%B9%E6%9C%89%EF%BC%9A
%0A- %0A
" excluded_dirs>：必须手动加 <code>["node_modules", ".git"]，否则补全列表塞满无关路径-
"root_path"：如果项目结构深（如frontend/src），设成frontend才能让src/开头的路径正确解析 - 不支持嵌套 glob：
**/*.png无效，只能靠目录层级 + 模糊字符（如输lgbtn匹配login-button.png）
它不替代 Ctrl+Shift+R，但解决的是另一个维度的问题：不是“我忘了文件在哪”，而是“我正在写引用，不想手动拼路径”。两者配合，才构成完整的模糊匹配工作流。
