需依次完成五步配置:一、用GHCup安装GHC、cabal和HLS;二、安装Haskell及语法高亮扩展;三、在settings.json中手动指定HLS路径;四、安装fourmolu并启用保存时格式化;五、配置launch.json实现GHCi调试。

如果您希望在 Visual Studio Code 中高效开发 Haskell 项目,但尚未配置合适的编辑器环境,则可能是由于缺少语言服务器、语法高亮、格式化工具或调试支持。以下是完成 Haskell 开发环境配置的步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装 Haskell 工具链
配置 VSCode 的前提是在系统中安装完整的 Haskell 构建与开发工具,包括编译器、包管理器和语言服务器依赖的基础运行时。
1、访问 https://www.haskell.org/ghcup/ 下载并运行官方推荐的 GHCup 安装脚本。
2、在终端中执行 curl --proto '=https' --tlsv1.2 -sSf https://get-ghcup.haskell.org | sh 启动交互式安装流程。
3、按提示选择默认选项完成 GHC、cabal 和 hls(Haskell Language Server)的安装。
4、重启终端,运行 ghc --version 与 haskell-language-server --version 验证安装结果。
二、安装 VSCode 扩展
VSCode 本身不内置 Haskell 支持,需通过扩展提供语法识别、类型检查、自动补全及代码跳转等核心功能。
1、打开 VSCode 扩展市场(Ctrl+Shift+X 或 Cmd+Shift+X)。
2、搜索并安装 Haskell 扩展(由 Haskell IDE Team 官方维护,ID: justusadam.language-haskell)。
3、搜索并安装 Haskell Syntax Highlighting(ID: carymrobbins.vscode-haskell)以增强高亮稳定性。
4、启用扩展后,重启 VSCode 确保所有语言特性加载生效。
三、配置 Haskell Language Server(HLS)路径
VSCode 的 Haskell 扩展默认尝试自动发现 HLS 可执行文件,但在多版本共存或非标准安装路径下可能失败,需手动指定。
1、在 VSCode 中按下 Cmd+, 打开设置界面,切换至“文本编辑器 > Haskell”设置页。
2、找到 Haskell > Server: Executable Path 选项。
3、点击“编辑 in settings.json”,在 JSON 中添加键值对:"haskell.serverExecutablePath": "/Users/yourname/.ghcup/bin/haskell-language-server"(路径需替换为实际输出 which haskell-language-server 的结果)。
四、启用自动格式化与保存时操作
Haskell 社区广泛采用 stylish-haskell 或 fourmolu 进行代码风格统一,VSCode 可将其集成到编辑流程中以提升协作一致性。
1、在终端中执行 cabal install fourmolu 安装格式化工具。
2、打开 VSCode 设置,搜索 format on save,勾选“Editor: Format On Save”。
3、在工作区根目录创建 .vscode/settings.json 文件,写入:{"haskell.formattingProvider": "fourmolu"}。
五、配置调试环境(GHCi 集成)
VSCode 支持通过 CodeLLDB 或内置调试适配器启动 GHCi 会话,便于交互式求值与断点调试,需正确声明启动参数与模块入口。
1、在项目根目录创建 .vscode/launch.json 文件,内容包含以下配置片段:
{"configurations": [{"type": "haskell","request": "launch","name": "GHCi REPL","cwd": "${workspaceFolder}","args": ["-i.","-package-db=dist-newstyle/packagedb/ghc-9.6.4"]}]}
2、确保当前项目已运行 cabal build 生成 dist-newstyle 目录结构。
3、按 Cmd+Shift+D 切换调试视图,选择 “GHCi REPL” 配置,点击绿色三角形启动交互式会话。











