Sublime Text配置Haskell语言函数式开发环境

时间：2026-05-05 08:15

Sublime Text 的 Haskell 功能完全依赖外部工具链，90% 配置失败源于 ghc、haskell-language-server 或 runhaskell 未正确加入 Sublime 的 PATH；必须确保终端能执行对应命令，并手动将路径注入 Sublime 环境变量，安装 Has

Sublime Text 的 Haskell 功能完全依赖外部工具链，90% 配置失败源于 ghc、haskell-language-server 或 runhaskell 未正确加入 Sublime 的 PATH；必须确保终端能执行对应命令，并手动将路径注入 Sublime 环境变量，安装 Haskell IDE（非 SublimeHaskell）和 LSP 插件，配置 Haskell.sublime-build，项目根目录需含 .cabal 或 hie.yaml 文件，修改配置后须重启 HLS 服务。

先明确一个核心事实：Sublime Text 本身并不运行 Haskell。我们期待的那些“运行”、“类型提示”、“跳转定义”功能，其实全都依赖外部工具链是否就位、路径是否被正确继承、插件是否与当前 Sublime 版本兼容。所以，如果配置总是不成功，别急着怀疑插件，90% 的情况是 ghc、haskell-language-server 或 runhaskell 压根没进入 Sublime 的 PATH。

确认 `ghc` 和 `haskell-language-server` 真正在系统里且可调用

这是整个配置的地基，必须打牢。Sublime 不会帮你安装 GHC，也不会自动去寻找 HLS 的路径——它只会忠实地按照环境变量去执行命令。

第一步，在终端里必须能跑通这三条命令：ghc --version、runhaskell --version、haskell-language-server --version。其中任何一条失败，Sublime 后续的配置都将是空中楼阁。
macOS 和 Linux 用户要特别注意：Sublime（尤其是从 Dock 或启动器启动时）默认不读取你 shell 配置的 PATH。你需要手动将 which ghc 输出的路径（例如 /Users/you/.ghcup/bin/ghc）塞进 Sublime 的环境变量里。
Windows 用户则需要检查系统 PATH 是否包含了 C:\Users\XXX\AppData\Roaming\ghcup\bin，同时确保没有“以管理员身份运行”启动 Sublime，这会导致环境隔离。
如何验证？在 Sublime 的控制台（Ctrl+`）里输入 import os; print(os.environ.get('PATH'))，看看输出里是否包含你 which ghc 得到的目录。

用 Package Control 装 `Haskell IDE`，别碰 `SublimeHaskell` 或 `ghc-mod`

这里有个关键选择：Sublime Text 4 已经彻底移除了对 Python 2 的支持，而老牌的 SublimeHaskell 和 ghc-mod 都严重依赖它。如果装错了，结果就是插件静默失效——类型不显示、悬停提示空白、甚至跳转到 GHC 的源码里去。

必须安装的是 Haskell IDE（作者是 fpco 或 haskell）。它基于 LSP 协议对接 haskell-language-server，是目前唯一能稳定支持 ST4 的方案。
顺带安装 LSP 插件（注意不是已废弃的 LSP-haskell），它是语言服务器通信的底层桥梁。
安装完成后，务必重启 Sublime。因为 HLS 进程在编辑器启动时就会绑定项目路径，不重启等于没配置。
打开一个 .hs 文件后，留意右下角状态栏，应该会出现 “Haskell: Ready” 的提示。如果没有，说明 HLS 没起来，得回头检查 PATH 或项目配置。

写对 `Haskell.sublime-build` 才能让 `Ctrl+B` 真正跑起来

Sublime 默认的 Build System 对 Haskell 来说是空的，如果不自定义，那就永远只能看语法高亮。但这份配置文件写错一行 JSON，就可能报 command not found 或者直接卡住不动。

文件保存位置是关键：必须是 Packages/User/Haskell.sublime-build，别放错目录。
命令配置有讲究：推荐使用 runhaskell 而非 ghc，例如 "cmd": ["runhaskell", "$file"]。这适合单文件快速测试，不会生成一堆中间文件。
错误跳转不能少：必须加上 "file_regex": "^(*?):([0-9]+):([0-9]+):? ?(.*)$"，否则编译错误时，你无法点击错误信息跳转到问题行。
Windows 用户注意：runhaskell.bat 要带上 .bat 后缀。如果路径包含空格，使用 "shell_cmd": "runhaskell \"$file\"" 会更稳妥。
最后提个醒：如果代码里有 getLine 这类需要交互输入的函数，按 Ctrl+B 肯定没反应。这不是 bug，而是 Sublime 的 build 系统不支持 stdin 阻塞。遇到这种场景，还是切回终端运行吧。

项目根目录缺 `.cabal` 或 `hie.yaml`，HLS 就静默降级

HLS 不是一个全局服务，它是按项目启动的。如果项目根目录缺少描述文件，它连模块依赖都解析不了，结果就是补全、跳转、类型推导全部失效，而且它还不报错——只是安静地当个“哑巴”。

最基础的要求：项目根目录必须有 your-project.cabal 或 package.yaml。如果没有，就建一个最简版的 .cabal 文件：
```
name: myproj
version: 0.1.0
build-type: Simple
executable: myproj
  main-is: Main.hs
```
想要完整的类型提示（比如显示 forall a. Eq a => a -> a 而不是简化版）？需要在项目根目录创建 hls.yaml，内容如下：
```
{"plugins": {"ghcide": {"typecheck": {"showFullTypes": true}}}}
```
使用 Stack 管理项目？记得在 .lsp-config.json 里指定 "command": ["haskell-language-server", "--stack"]，否则 HLS 可能会错误地使用 Cabal 的 GHC。
修改完任何配置后，必须执行 Ctrl+Shift+P → Haskell: Restart Server，仅仅重新加载项目是不够的。