Sublime如何配置Haskell开发支持?(函数式编程环境)

2次阅读

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

Sublime如何配置Haskell开发支持?(函数式编程环境)

安装 Haskell 工具链前先确认 ghccabal 是否可用

Sublime 本身不运行 Haskell,它只靠外部工具提供语法高亮、构建和跳转。所以第一步不是装插件,而是确保系统里真有 ghccabal(或 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.yamlcabal.project 路径

即便 HLS 进程跑起来了,跳转定义仍可能失败,最常被忽略的原因是项目结构没被正确识别。
比如:

  • 项目根目录下没有 cabal.project,但子目录有 mylib.cabalmyapp.cabal —— HLS 默认只扫描当前目录,不会递归找 cabal 文件
  • 用了 Stack,但没生成 hie.yaml,或者 hie.yamlcradle 类型写成 cabal 而非 stack
  • Sublime 当前打开的是单个 .hs 文件,而非整个文件夹(即没用 subl .),LSP 插件就找不到项目配置文件

解决方式很直接:在项目根目录运行 haskell-language-server --debug src/Main.hs,看输出里是否成功加载 cradle;如果报 “No project config found”,就说明路径或配置文件名不对。

text=ZqhQzanResources