先确认系统已安装ghc、cabal和haskell-language-server并加入path,再安装haskell-sublime插件但禁用其构建系统,改用自定义stack.sublime-build;接着安装lsp及lsp-haskell,并通过.lsp-config.json指定–stack参数,最后确保项目根目录含cabal.project或hie.yaml且用subl .打开项目。

安装 Haskell 工具链前先确认 ghc 和 cabal 是否可用
Sublime 本身不运行 Haskell,它只靠外部工具提供语法高亮、构建和跳转。所以第一步不是装插件,而是确保系统里真有 ghc 和 cabal(或 haskell-language-server)在 $PATH 里。
常见错误是:装了 Stack 却没把 ~/.local/bin 或 ~/.stack/programs/x86_64-osx/ghc-*/bin 加进环境变量,导致 Sublime 找不到 ghc。
验证方法很简单,在终端运行:
which ghc<br>which cabal<br>which haskell-language-server
如果任一命令返回空,Sublime 后续所有功能都会静默失效。
用 Package Control 安装 Haskell-Sublime 插件但别依赖它默认构建系统
这个插件提供基础语法高亮、括号匹配和简单缩进,但它自带的 Build with cabal 构建系统在现代项目中基本不可用——它硬编码调用 cabal build,不识别 cabal.project,也不支持 multi-package 工作区。
建议做法:
- 保留
Haskell-Sublime做语法支持,但禁用它的构建系统(在Tools → Build System → Automatic关闭后手动切到None) - 改用
subl .从终端打开项目根目录,让 Sublime 正确识别工作区层级 - 如果用 Stack,可手动配置一个自定义构建系统,内容为:
{<br> "cmd": ["stack", "build"],<br> "selector": "source.haskell"<br>}保存为
Stack.sublime-build放进Packages/User/
启用 haskell-language-server 需要额外配置 LSP 插件
语法高亮只是起点,真正需要的是类型检查、跳转定义、自动补全,这得靠 haskell-language-server(简称 HLS)。但 Sublime 默认不支持 LSP,必须装 LSP 插件,并手动配 LSP-haskell 子包。
关键点:
-
LSP插件本身不带任何语言服务器,得再装LSP-haskell(通过 Package Control 搜索即可) -
LSP-haskell默认尝试启动haskell-language-server,但如果项目是 Stack 管理的,它可能错用 Cabal 的 GHC;此时需在项目根目录加.lsp-config.json,内容为:{<br> "haskell-language-server": {<br> "command": ["haskell-language-server", "--stack"]<br> }<br>} - 如果 HLS 启动失败,Sublime 底部状态栏会显示 “starting…” 卡住几秒后消失——这不是插件问题,大概率是
haskell-language-server编译失败或版本不匹配(比如用 GHC 9.2 编译的 HLS 无法服务 GHC 9.4 项目)
调试和类型提示失效时优先查 hie.yaml 和 cabal.project 路径
即便 HLS 进程跑起来了,跳转定义仍可能失败,最常被忽略的原因是项目结构没被正确识别。
比如:
- 项目根目录下没有
cabal.project,但子目录有mylib.cabal和myapp.cabal—— HLS 默认只扫描当前目录,不会递归找 cabal 文件 - 用了 Stack,但没生成
hie.yaml,或者hie.yaml里cradle类型写成cabal而非stack - Sublime 当前打开的是单个
.hs文件,而非整个文件夹(即没用subl .),LSP 插件就找不到项目配置文件
解决方式很直接:在项目根目录运行 haskell-language-server --debug src/Main.hs,看输出里是否成功加载 cradle;如果报 “No project config found”,就说明路径或配置文件名不对。