VSCode配置Haskell编译器函数式编程VSCode环境快速集成-VSCode-PHP中文网

ghcup是当前最可靠、最可控的haskell工具链安装方式，可统一管理ghc、cabal和hls，避免版本错配；必须配置中科大镜像源加速国内安装，windows需在powershell中设置环境变量并启用执行策略，安装时勾选hls、指定非c盘路径、自动写入path，vscode中须手动配置haskell.serverexecutablepath路径，且项目根目录需含.cabal或stack.yaml文件才能触发hls。

vscode配置haskell编译器函数式编程vscode环境快速集成

ghcup 是当前最可靠、最可控的 Haskell 工具链安装方式，比 stack 或旧版 Haskell Platform 更适合 VSCode 集成。它能统一管理 ghc、cabal 和 haskell-language-server（HLS），避免版本错配导致的“有提示但不工作”问题。

用 `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，避免权限和空间问题
务必选“Yes”让 ghcup 自动写入 PATH，否则 VSCode 终端里 ghc --version 会报 command not found

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

即使装了 HLS，VSCode 的 Haskell 插件也常因自动探测失败而静默降级为“仅语法高亮”。解决方法是强制指定可执行文件路径：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

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

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

VSCode 的 Haskell 插件依赖项目元数据启动语言服务器。空文件夹或仅含 .hs 文件不会触发 HLS 加载，表现为“悬停无类型、跳转失效、错误不标红”。

新建项目推荐用 cabal init（确保已安装 cabal）或 ghcup install cabal 后再执行
若已有代码，可在项目根目录手动生成最小 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 &&

保存后重启 VSCode 窗口（不是重载窗口），或右键 demo.cabal → “Initialize Haskell project”
不要用 stack new 创建的项目直接开根目录——它默认不含 .cabal，需先 stack init 或手动补全

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

VSCode 内置终端无法直接识别 cabal run 或 stack run，需配置任务或手动调用。常见混淆点：

临时测试单个 Main.hs：终端中直接运行 runhaskell Main.hs，无需构建
运行已定义的可执行目标（如 .cabal 中的 executable）：必须先 cabal build，再 cabal exec demo-exe
用 stack 管理的项目：运行前先 stack build，然后 stack exec demo-exe（名字来自 stack.yaml 中的 executables 字段）
VSCode 任务配置中，command 值应为 runhaskell 或 cabal exec，不能写成 cabal run（该命令在部分版本中不接受参数）