VSCode本身不执行Haskell代码，真正运行依赖系统工具链：runhaskell（单文件）、ghci（交互调试）或构建后执行可执行文件；需确保GHC/HLS已安装且PATH正确、项目结构合法（含.cabal或stack.yaml）、依赖声明完整，方可正常运行。
VSCode 本身不执行 Haskell 代码，它只负责调用系统已安装的工具链；真正运行靠的是 runhaskell、ghci 或构建后执行可执行文件。只要工具链装对、路径通、项目结构合法，运行就是一行命令的事——不是插件配置出来的，而是你终端里本来就有的能力。
为什么点“运行”没反应？检查这三点
VSCode 没有内置 Haskell 运行按钮，所谓“运行”必须手动配置任务或依赖终端。常见静默失败原因：
-
runhaskell命令不可用：说明 GHC 没装，或~/.ghcup/bin（Linux/macOS）或%USERPROFILE%\.ghcup\bin（Windows）没进PATH - 打开的是单个
.hs文件，而非含.cabal或stack.yaml的项目根目录：HLS 不启动 → 插件不激活 → 无上下文 → 无法推导模块依赖 →runhaskell可能报Could not find module - 文件里用了
import但没声明依赖：比如import Data.Text却没在.cabal的build-depends里加text，runhaskell直接失败，且 VSCode 不提示具体缺哪个包
用 tasks.json 一键运行单文件（推荐新手）
无需项目结构，适合练习语法或写小脚本。在项目根目录建 .vscode/tasks.json：
{
"version": "2.0.0",
"tasks": [
{
"label": "Run Haskell File",
"type": "shell",
"command": "runhaskell",
"args": ["${file}"],
"group": "build",
"presentation": {
"echo": true,
"reveal": "always",
"focus": false,
"panel": "shared",
"showReuseMessage": true,
"clear": true
}
}
]
}
保存后按 Ctrl+Shift+P → 输入 Tasks: Run Task → 选 Run Haskell File。注意：${file} 是当前编辑的文件路径，所以务必确保该文件是独立可运行的（比如只有 main :: IO ()，没外部依赖）。
HLS 就绪后才能可靠运行项目级代码
单文件 runhaskell 解决不了真实项目问题。真正要跑带依赖的项目，必须让 HLS 正确加载上下文，否则类型检查都错，更别说运行。关键动作：
- 用
stack new myproj或cabal init创建标准项目（生成myproj.cabal或stack.yaml） - 在 VSCode 中用
File → Open Folder打开整个项目文件夹，不是Open File - 等待右下角状态栏出现
HLS ready（不是Loading...），再执行stack run或cabal run（在 VSCode 集成终端里） - 如果卡在
Loading...，打开输出面板 → 切换到Haskell标签，看是否报Failed to start language server—— 八成是 GHC 和 HLS 版本不匹配，查ghc --version和haskell-language-server --version输出里的 GHC 绑定版本是否一致
调试时别只信“运行”，要会用 ghci
VSCode 的 Haskell 插件支持 ghci 交互式调试，比直接运行更实用：
- 打开一个
.hs文件，在编辑器里右键 →Start GHCi Session（或按Ctrl+Shift+P→Haskell: Start GHCi Session） - 会自动加载当前模块，并进入交互环境；输入
main或任意函数名即可执行 - 若报
module not found，确认该文件在.cabal的other-modules或exposed-modules里声明了，否则ghci不知道该加载谁 - 修改代码后，输入
:r重载，比反复runhaskell快得多
最容易被忽略的一点：所有运行行为都依赖终端里实际可用的命令，而不是 VSCode 设置里写的路径。哪怕 haskell.serverExecutablePath 配对了，runhaskell 没进 PATH，照样跑不通。每次配完先在 VSCode 集成终端里手动敲一遍 runhaskell --version 和 ghci --version，比看日志更快定位问题根源。
