适合Haskell函数式开发的VSCode快捷键与配置-VSCode-PHP中文网

vscode 本身不提供 haskell 专属快捷键，所有运行、调试、格式化行为均依赖底层命令（如 runhaskell、ghci）是否就位、tasks.json 是否正确配置、项目结构（含 .cabal 或 stack.yaml）是否合法，以及 haskell.serverexecutablepath 是否设为绝对路径；缺一不可。

适合haskell函数式开发的vscode快捷键与配置

VSCode 本身不提供 Haskell 专属快捷键，所有“运行”“调试”“格式化”行为都依赖你是否配对了底层命令和项目结构；没装 runhaskell、没设 haskell.serverExecutablePath、或打开方式错成单文件，按什么键都没用。

Ctrl+Shift+B 运行不了？检查 tasks.json 和 runhaskell 是否就位

这个组合键本质是触发 tasks.json 里定义的 task，不是插件功能。常见失败原因：

runhaskell 命令在 VSCode 集成终端里执行失败 → 说明 ~/.ghcup/bin（Linux/macOS）或 %USERPROFILE%.ghcupin（Windows）没进 PATH，或根本没装 GHC
tasks.json 中 "command" 写成了 ghci 或 stack run，但当前目录没有 stack.yaml → 报错 Could not find stack.yaml
"args": ["${file}"] 指向的文件不含 main :: IO ()，或用了未声明的 import → runhaskell 直接退出，无输出

可靠配置只有一条路：用 runhaskell 跑单文件。确保 tasks.json 是这样：

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Run Haskell File",
      "type": "shell",
      "command": "runhaskell",
      "args": ["${file}"],
      "group": "build",
      "presentation": {
        "echo": true,
        "reveal": "always",
        "panel": "shared",
        "clear": true
      }
    }
  ]
}

如果 runhaskell 不在 PATH，把 "command" 改成绝对路径，比如 /home/you/.ghcup/bin/runhaskell 或 C:\ghcup\bin\runhaskell.exe。

F5 调试灰色不可用？launch.json + ghci + 项目结构三者缺一不可

F5 不是“点一下就进断点”，它依赖 VSCode 的调试器 + ghci + HLS 提供的模块上下文。三个条件必须同时满足：

launch.json 必须存在且 "type" 设为 ghci（不是 haskell），例如："type": "ghci"、"request": "launch"、"program": "${file}"
当前文件必须能被 ghci 加载：即不含语法错误、所有 import 已在 .cabal 的 build-depends 声明，或使用 stack ghci 启动
VSCode 必须以 Open Folder 方式打开含 .cabal 或 stack.yaml 的根目录 —— 否则 HLS 不加载，F5 灰色，右下角状态栏卡在 Starting...

别指望 F5 自动识别单个 Main.hs。哪怕内容完全正确，只要没 .cabal 文件，F5 就不会激活。

VSCode

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

下载

Ctrl+Click 跳转失效？haskell.serverExecutablePath 必须填绝对路径

Haskell 插件（ID: haskell.haskell）默认只找 haskell-language-server，但它不认 haskell-language-server-wrapper，也不 fallback 到 ~/.ghcup/bin/。结果就是悬停无类型、跳转标红、状态栏不动。

解决方法只有一步：手动填死路径。

终端运行 which haskell-language-server（Linux/macOS）或 Get-Command haskell-language-server（PowerShell）拿到完整路径
VSCode 设置中搜 haskell.serverExecutablePath，粘贴进去，例如：/home/you/.ghcup/bin/haskell-language-server
重启整个 VSCode 窗口（不是重载窗口），否则设置不生效

填 haskell-language-server-wrapper 会失败 —— 它只是个版本路由脚本，VSCode 的调试器和 LSP 客户端不支持它。

保存自动格式化不工作？fourmolu 和 formatter 配置必须绑定到 Haskell 语言模式

VSCode 的格式化是语言感知的，fourmolu 不会自动生效，必须显式告诉编辑器：“Haskell 文件保存时，用 fourmolu 格式化”。步骤如下：

先确保已安装 fourmolu：cabal install fourmolu 或 ghcup install fourmolu
在 VSCode 设置中搜索 format on save，勾选 Editor: Format On Save
再搜 default formatter，找到 Haskell > Format: Default Formatter，设为 fourmolu
确认 settings.json 中有这段（自动生成）："[haskell]": { "editor.formatOnSave": true, "editor.defaultFormatter": "haskell.haskell" } —— 注意最后那个 "haskell.haskell" 是插件 ID，不是可执行名