subl命令未找到是因未创建软链接，需手动执行sudo ln -sf "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl，并确保/usr/local/bin在PATH中。
subl 命令提示 command not found
这不是 Sublime 没装好，而是系统根本没找到 subl 这个可执行文件。Mac 上 Sublime Text 4 默认不把 subl 加入 PATH，必须手动建软链接。
- 确认二进制路径存在：
/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl（注意不是 Sublime Text 2/3 的旧路径） - 执行：
sudo ln -sf "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl - 检查
/usr/local/bin是否在 PATH 中：echo $PATH输出里要有/usr/local/bin - 别用
brew install --cask sublime-text期望它自动配好——它不会创建subl链接 - 不要链到
/usr/bin/subl：macOS SIP 会阻止写入，且可能被系统清理
subl 打开文件但定位失败（如 :42 不跳转）
行号/列号定位是 subl 的内置能力，但格式非常严格，错一个字符就静默失效——不报错，也不跳转，只是打开文件顶部。
- 语法必须是
subl path/to/file.py:42或subl path/to/file.py:42:15，冒号不能省，不能有空格 - 列号是可选的，但一旦写了，必须跟在行号后、第二个冒号之后；
:42:或:42:都无效 - 相对路径依赖当前终端工作目录，
subl ./src/main.go:10在错误目录下会打开空白或错误文件 - 不支持模糊行号（如
:~42）、正则、或符号引用（如:main） - 该功能由 Sublime 内部
load_file命令实现，仅解析静态数字，无容错机制
subl . 启动后不新建窗口，而是挤进已有窗口
默认行为是复用最近活动窗口，这在调试多个项目时容易串上下文。需要显式传参控制窗口策略。
- 强制新开独立窗口：
subl --new-window . - 在已有窗口中新增项目文件夹（非覆盖）：
subl --add . - 两者可组合：
subl --new-window --add ./backend ./frontend，启动新窗口并同时加载两个目录 -
--new-window和--add是互斥逻辑：不加--add时，--new-window会清空原窗口所有文件夹；加了才追加 - 注意：这些参数必须放在路径之前，
subl . --new-window会被忽略
subl --help 无输出或报错
说明软链接指向了错误路径，或链接本身损坏。常见于升级 Sublime 后未更新链接，或路径含空格未引号包裹。
- 先检查链接目标是否真实可执行：
ls -l /usr/local/bin/subl，输出应显示指向.../bin/subl - 如果指向路径含空格（如
Sublime Text.app），确保ln -sf命令中整个路径用英文双引号包裹 - 运行
/Applications/Sublime\ Text.app/Contents/SharedSupport/bin/subl --help直接测试原路径——若成功，说明链接有问题 - 链接损坏时，
file /usr/local/bin/subl可能返回 “cannot open” 或 “broken symlink” - 重做链接前，先
rm /usr/local/bin/subl清理旧链接，避免叠加失效
bin/subl 路径和 Text 3 完全不同，升级后旧链接立即失效，但错误表现只是 command not found，看不出版本线索。 
