Sublime启动时不读shell配置文件,需在用户设置中配置env.PATH或构建系统中使用绝对路径。macOS/Linux用冒号分隔路径并前置自定义路径,Windows用分号且反斜杠双写;修改后须完全退出重开才生效。

Sublime 启动时根本没读你的 shell 配置文件
你在终端里能跑 eslint、prettier 或 ghc,但 Sublime 里 Ctrl+B 就报 command not found——这不是你 PATH 写错了,而是 Sublime 启动时压根没执行 ~/.zshrc、~/.bash_profile 或 Windows 的用户环境变量。它只继承系统级 PATH(比如 /usr/bin),不 source 任何 shell 初始化脚本。
所以别再反复检查 echo $PATH 和 which xxx 是否一致了。真正要做的,是让 Sublime “知道”你想要的那些路径在哪:
- Linux/macOS:在 Sublime 的
Preferences.sublime-settings(用户设置)里加"env": {"PATH": "/opt/homebrew/bin:/usr/local/bin:$PATH"},注意用冒号分隔,且必须把自定义路径放前面 - Windows:同样在用户设置中写
"env": {"PATH": "C:\Users\me\AppData\Roaming\npm;C:\msys64\mingw64\bin;$PATH"},反斜杠必须双写,路径间用分号 - 改完后必须完全退出 Sublime(不是关窗口,是右键托盘图标 → Exit),再重新打开才生效
构建系统里硬写绝对路径比依赖 env 更可靠
靠 env.PATH 注入有局限:不同项目可能需要不同版本的工具(比如 Node 16 vs 20),或某些工具(如 tsc)装在 node_modules/.bin 下,路径随项目变。这时硬编码反而更稳。
例如 TypeScript 构建系统:{"cmd": ["/Users/me/project/node_modules/.bin/tsc", "-p", "."]};又比如 PHP 检查:{"cmd": ["/opt/homebrew/bin/phpcs", "--standard=PSR12", "$file"]}。
关键点:
- 先在终端运行
which phpcs或npx which tsc拿到真实路径 - macOS/Linux 路径用正斜杠
/,Windows 用正斜杠或双反斜杠C:/path/to/tsc,千万别用单反斜杠C:path(JSON 解析会失败) -
$file、$file_path这类变量可直接用,但不要试图在cmd数组里拼接字符串,比如["/usr/bin/" + "prettier"]是无效的
Windows 下 subl 命令不存在?先确认是不是 PATH 根本没配
subl 命令不是安装 Sublime 就自动有的。macOS 必须通过菜单栏 Sublime Text → Install Command Line Tool 手动触发;Linux tarball 版得自己建软链接;Windows 则必须在安装时勾选 Add to PATH,漏了就得手动加。
dotenvx 是由 dotenv 的创建者推出的_secure、跨平台环境变量管理器。它提供加密的 .env 文件、多环境支持,并通过其 CLI 运行器与任何编程语言或框架配合使用。
验证是否真可用:
- macOS/Linux:终端输
which subl,有输出再试subl --version - Windows:命令提示符输
where subl,没结果就去系统环境变量里把C:Program FilesSublime Text加进 Path - 如果仍不行,可以临时在 Sublime 用户设置里补一句
"env": {"PATH": "C:\Program Files\Sublime Text;$PATH"},但这只是 workaround,不是根本解法
LSP 插件(如 LSP-haskell)启动卡在 “Starting…” 的真实原因
状态栏一直显示 Haskell: Starting… 不变绿,99% 不是插件坏了,而是 haskell-language-server(HLS)进程根本没起来,或者起来了但找不到项目配置。LSP 插件只是个转发代理,它不负责解析代码。
排查顺序必须是:
- 终端进项目根目录,手动运行
haskell-language-server --debug .,看有没有报错(比如找不到hie.yaml或 GHC 版本不匹配) - 确认
hie.yaml或hls.yaml存在且格式正确,cradle 配置指向了正确的 build 工具(cabal还是stack) - 检查 HLS 版本是否和当前 GHC 兼容(例如 GHC 9.4.x 需 HLS 2.4.x,差一个 patch 版本都可能静默失败)
- 改完配置后必须
Ctrl+Shift+P → LSP: Restart Servers,只重启 Sublime 没用——旧 HLS 进程还挂着
环境变量问题在这里最隐蔽:即使 which haskell-language-server 有输出,Sublime 的 LSP 也可能因没继承 shell PATH 而找不到它,此时就得在 LSP 插件的 settings 里显式指定 "settings": {"haskell-language-server": "/opt/homebrew/bin/haskell-language-server"}。










