安装时没勾“add to path”会导致subl命令不可用，出现command not found错误，进而使git commit编辑器失效、脚本调用subl .失败；windows需重装并勾选该选项，macos/linux须手动配置软链接或path。
安装时没勾“Add to PATH”会导致什么？
命令行输 subl 直接报错 command not found，Git commit message 编辑器失效、脚本中调用 subl . 启动项目全部中断。这不是后期能“补救”的配置，而是安装阶段就决定的系统级注册行为。
Windows 用户必须在安装向导“Select Components”页明确勾选 Add to PATH；macOS 用户需额外运行 sudo ln -s /Applications/Sublime Text.app/Contents/SharedSupport/bin/subl /usr/local/bin/subl（注意：若已启用 SIP，/usr/local/bin 可能不可写，应改用 /opt/homebrew/bin/ 或手动加到 $PATH）；Linux 通过 apt install 安装的版本默认不带 subl 命令，必须从官网下载 tarball 并手动软链。
常见错误现象：
-
subl: command not found即使which subl返回空 -
git config --global core.editor "subl --wait"执行后 commit 仍弹出 vim - 终端里能运行
open -a "Sublime Text"，但不能用subl
用户设置里怎么安全地定义全局变量？
Sublime Text 不支持传统意义上的“全局变量”，但可通过 Preferences → Settings – User 中的 settings 字段间接实现跨项目生效的路径/参数复用。关键不是写变量名，而是用 $project_path、$file_path 等内置占位符组合出可复用逻辑。
例如，想让所有 C++ 构建命令统一使用本地 MinGW 路径，不要硬编码 "shell_cmd": "C:/MinGW/bin/g++.exe ..."，而应：
- 确保 MinGW 的
bin目录已在系统PATH中（验证：终端运行g++ --version） - 在构建系统
.sublime-build文件里只写"shell_cmd": "g++ "$file" -o "$file_base_name.exe" -std=c++17" - 如必须指定绝对路径，用
${env:PATH}动态读取，而非静态字符串
直接在 Settings – User 里写 "my_compiler_path": "C:/MinGW/bin" 是无效的——Sublime 不解析自定义字段，仅识别白名单键名（如 font_size、ignored_packages）。
为什么 ignored_packages 改了不生效？
因为插件加载顺序和缓存机制：Sublime 启动时先读默认配置（含预设 ignored_packages），再合并用户配置；但某些插件（如 ChineseLocalization）会在首次启动后往 ignored_packages 里自动塞项，覆盖你的手动设置。
正确做法是：
- 关闭 Sublime Text 全进程（包括托盘图标）
- 打开
Preferences → Settings – User，确认"ignored_packages"是数组类型，且不含拼写错误（如"Vintage"不是"vintage"） - 删掉
Package Control.sublime-package文件（位于Packages/目录下），强制重装包管理器 - 重启后立即按
Ctrl+Shift+P输入Package Control: Satisfy Dependencies，避免插件因依赖缺失自我禁用
典型陷阱：把 "ignored_packages": ["ChineseLocalization"] 写成 "ignored_packages": "ChineseLocalization"（字符串非数组），导致整个配置文件解析失败，回退到默认值。
Build System 里 working_dir 和 shell_cmd 的路径斜杠怎么选？
Windows 下必须用正斜杠 / 或双反斜杠 \，单反斜杠 是转义字符，会破坏 JSON 结构。macOS/Linux 一律用正斜杠 /，别信“Mac 用冒号”这类过时说法。
示例对比：
- ❌ 错误：
"working_dir": "C:Projectsmyapp"（JSON 解析失败） - ✅ 正确：
"working_dir": "C:/Projects/myapp"或"working_dir": "C:\Projects\myapp" - ✅ 跨平台安全写法：
"working_dir": "$file_path"（自动展开为当前文件所在目录）
更隐蔽的问题是 shell_cmd 中的引号嵌套：Windows cmd 不认单引号，必须用双引号包裹路径；PowerShell 则对引号更宽容，但 Sublime 默认调用的是 cmd。所以 "shell_cmd": "g++ "${file}" -o "${file_base_name}.exe"" 是唯一可靠写法。
容易被忽略的地方：构建系统保存路径必须是 Packages/User/xxx.sublime-build，放错位置（比如丢进 Packages/Default/）会导致重启后配置丢失，且不会报错。
