VSCode for Haskell：配置HLS，享受现代开发体验_网络技术

发布时间 - 2026-01-05 00:00:00 点击率：次

需安装GHC/Cabal、配置Haskell扩展、按项目类型设hie.yaml，并验证HLS连接状态。具体包括：brew安装工具链；VSCode装官方扩展并设HLS路径；Stack/Cabal项目分别配hie.yaml；通过日志和状态栏确认运行正常。

如果您希望在 VSCode 中为 Haskell 项目启用类型检查、自动补全和实时错误提示等功能，则必须正确配置 Haskell Language Server（HLS）。以下是完成此配置的具体步骤：

本文运行环境：MacBook Air，macOS Sequoia。

一、安装 Haskell 工具链

在启用 HLS 前，需确保系统已安装 GHC 和 Cabal 或 Stack，它们是 HLS 正常运行的基础依赖。HLS 本身不包含编译器，而是依赖本地已安装的 Haskell 构建工具来解析项目结构与类型信息。

1、打开终端，执行 brew install ghc cabal-install 安装 GHC 与 Cabal。

2、运行 cabal update 更新包索引。

3、执行 cabal install hls 安装最新稳定版 HLS 可执行文件。

4、确认安装成功：输入 haskell-language-server --version，应输出版本号及支持的 GHC 版本范围。

VSCode 需通过官方 Haskell 扩展识别并启动 HLS，同时需关闭可能冲突的旧扩展（如 Haskero 或 Haskell-ghc-mod），避免语言服务器重复激活或端口占用。

1、在 VSCode 扩展市场中搜索并安装 Haskell（作者：haskell.haskell），该扩展由 Haskell 社区官方维护。

2、打开 VSCode 设置（Cmd + ,），进入 Extensions → Haskell 设置页。

3、将 Haskell: Executable Path 设置为 haskell-language-server（若已加入 PATH）或指定其绝对路径（如 /Users/username/.cabal/bin/haskell-language-server）。

4、勾选 Haskell: Enable HLS，确保开关处于启用状态。

HLS 的行为会根据项目根目录下是否存在 stack.yaml、cabal.project 或 hie.yaml 文件而自动切换后端驱动。若检测失败，需手动指定驱动类型，否则无法加载模块或报告类型错误。

1、对于使用 Stack 构建的项目，在项目根目录创建 hie.yaml，内容为：cradle: {stack: {}}。

2、对于使用 Cabal 构建的项目，hie.yaml 内容应为：cradle: {cabal: {}}。

3、若项目无构建配置但含 .hs 文件，可使用 direct 模式：hie.yaml 中写入 cradle: {direct: {arguments: []}}。

4、保存 hie.yaml 后，重启 VSCode 窗口或执行命令面板中的 Haskell: Restart Haskell Language Server。

即使扩展启用且路径正确，HLS 仍可能因权限、GHC 版本不匹配或项目路径含空格而静默失败。此时需检查输出面板中 “Haskell” 日志流，定位初始化中断点。

1、打开 VSCode 命令面板（Cmd + Shift + P），输入并选择 Developer: Toggle Developer Tools。

2、切换到 Console 标签页，观察是否有 Failed to start haskell-language-server 类报错。

3、回到 VSCode 底部状态栏，点击左侧 Haskell 图标，查看当前连接状态与使用的 GHC 版本。

4、若显示 Not connected，点击图标后选择 Restart server 并留意输出面板中是否出现 Started haskell-language-server 成功日志。