VSCode配置Haskell编译器 函数式编程VSCode环境快速集成

在Haskell开发环境的搭建中，工具链的版本匹配问题一直是新手甚至老手的“暗坑”——装了GHC跑不起来，安装了HLS却没有任何类型提示，这种情况在实际项目中并不少见。究其原因，往往是ghc、cabal和haskell-language-server（HLS）之间版本错配，而ghcup恰恰是当前最可靠、最可控的解决方案。相比stack或旧版Haskell Platform，它更适合与VSCode集成，能够统一管理这三者，从源头避免“有提示但不工作”的尴尬局面。

用 ghcup 安装并指定中科大镜像源

国内直接连接官方源，速度慢到让人崩溃，甚至可能直接超时失败。换源是第一步，也是关键的一步。Windows用户请在PowerShell（非管理员模式）下执行以下命令：

$env:BOOTSTRAP_HASKELL_YAML = 'https://mirrors.ustc.edu.cn/ghcup/ghcup-metadata/ghcup-latest.yaml'
Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
Invoke-Command -ScriptBlock ([ScriptBlock]::Create((Invoke-WebRequest https://mirrors.ustc.edu.cn/ghcup/sh/bootstrap-haskell.ps1 -UseBasicParsing))) -ArgumentList $true

• 执行后一路按 Enter，但有一个步骤绝对不能跳过：安装时务必勾选 HLS（Haskell Language Server）。如果不勾选，VSCode启动后你得到的就只有语法高亮，没有任何类型提示，那就和记事本写代码没区别了。
• 安装路径建议避开 C:\，比如设为 D:\ghcup，这样可以避免后续的权限问题和磁盘空间紧张。
• 当系统询问是否让 ghcup 自动写入 PATH 时，一定要选“Yes”。否则你会发现，在VSCode终端里输入 ghc --version 会直接报“command not found”。

VSCode 中手动指定 haskell-language-server-wrapper 路径

哪怕你已经装好了HLS，VSCode中的Haskell插件也经常因为自动探测失败而悄悄降级——表面上看插件正常加载，实际上只提供了语法高亮，类型检查、跳转定义、错误标注统统缺失。这背后的原因就是插件没有找到HLS的可执行文件。解决方法很简单：强制告诉它路径。

• 打开VSCode设置（Ctrl+,），搜索 haskell.serverExecutablePath
• 填入完整的可执行文件路径。Windows下通常是：D:\ghcup\bin\haskell-language-server-wrapper.exe
• Linux/macOS用户对应路径类似：~/.ghcup/bin/haskell-language-server-wrapper
• 如果不确定HLS安装到了哪里，可以在终端运行 which haskell-language-server-wrapper，或者用 ghcup list 查看已安装的HLS版本及其对应路径。

项目根目录必须含 .cabal 或 stack.yaml

这个细节很容易被忽略：VSCode的Haskell插件并不是靠识别 .hs 文件来启动语言服务器的，它依赖的是项目元数据。假如你打开一个空文件夹，或者里面只有几个零散的 .hs 文件，HLS根本不会加载。表现就是：鼠标悬停没有类型提示、符号跳转失效、代码错误也不标红。

• 新建项目时，推荐使用 cabal init 来生成项目骨架。当然前提是你已经安装了 cabal（可以用 ghcup install cabal 来安装）。
• 如果手头已有现成的 .hs 代码，可以在项目根目录手动创建一个最小的 demo.cabal 文件：

name:                demo
version:             0.1.0.0
build-type:          Simple
cabal-version:       >=1.10
executable demo
  main-is:             Main.hs
  build-depends:       base >=4.7 && <5
  default-language:    Haskell2010

• 保存文件后，重启VSCode窗口（注意不是重载窗口），或者在资源管理器中右键 demo.cabal 选择“Initialize Haskell project”。
• 特别提醒：用 stack new 创建的项目，在根目录下默认是不包含 .cabal 文件的（它用的是 stack.yaml），直接打开根目录时HLS同样不会启动。你需要先执行 stack init 或者手动补充 .cabal 才能触发。

runhaskell 运行单文件 vs stack exec 运行可执行目标

很多人在VSCode内置终端里直接用 cabal run 或 stack run，却发现报错或者没有反应。这是因为VSCode终端并不能自动识别需要构建的项目结构。这里有两个常见场景需要区分清楚：

• 临时测试单个 Main.hs 文件：直接在终端运行 runhaskell Main.hs 即可，不需要任何构建过程，特别适合快速验证小段逻辑。
• 运行已定义的可执行目标（比如 .cabal 文件中已经声明了 executable）：必须先执行 cabal build 完成编译，然后再使用 cabal exec demo-exe 来运行（这里的 demo-exe 是你在 .cabal 里定义的可执行文件名）。
• 对于 stack 管理的项目：运行之前同样需要 stack build 编译，然后通过 stack exec demo-exe 来执行，可执行文件名来自 stack.yaml 中 executables 字段。
• 如果你在VSCode中配置任务（tasks.json），command 的值应当写成 runhaskell 或 cabal exec，而不是 cabal run——因为某些版本的 cabal 不接受 run 后面的参数，会导致任务执行失败。

最后还必须强调一点：HLS对GHC的版本极其敏感。当你用 ghcup install ghc 9.6.4 安装了一个GHC版本之后，必须用 ghcup install hls 9.6.4 安装对应版本的HLS。哪怕只差一个小版本号，都可能引发“HLS服务器崩溃后自动重启”的死循环。这个细节在初始化项目时最容易被跳过，但它恰恰是整个环境能否正常工作的关键所在。