Haskell Language Server（HLS）未正确配置会导致VSCode中缺失类型提示、跳转定义和实时错误标记；需通过GHCup安装GHC、Cabal与HLS，启用官方Haskell扩展，配置serverPath路径，并在含.cabal或stack.yaml的项目中验证功能。
如果您在VSCode中编辑Haskell代码时无法获得类型提示、跳转定义或错误实时标记，则很可能是Haskell Language Server（HLS）未正确配置。以下是完成该配置的具体步骤：
本文运行环境：MacBook Pro，macOS Sequoia
一、安装GHCup及配套工具链
GHCup是Haskell官方推荐的跨平台安装管理器，可统一安装GHC、Cabal、Stack与HLS。它能避免手动配置路径冲突，并确保各组件版本兼容。
1、打开终端，执行官方一键安装命令：curl --proto '=https' --tlsv1.2 -sSf https://get-ghcup.haskell.org | sh
2、按提示完成安装后，运行 ghcup install ghc 安装最新稳定版GHC
3、运行 ghcup install cabal 安装Cabal构建工具
4、运行 ghcup install hls 安装Haskell Language Server
5、执行 ghcup set hls 将当前HLS设为默认版本
二、在VSCode中启用HLS扩展
VSCode需通过官方Haskell扩展与本地HLS进程通信。该扩展不内置服务器，仅作为客户端桥接器，因此必须配合已安装的HLS二进制文件使用。
1、在VSCode扩展市场中搜索 Haskell，选择由 Haskell Organization 发布的官方扩展并安装
2、重启VSCode，确保扩展激活状态显示为“已启用”
3、打开任意 .hs 文件，观察右下角状态栏是否出现 HLS: Ready 提示
4、若显示 HLS: Not found，点击该提示，选择 Download and install HLS —— 此操作将调用GHCup自动补全缺失组件
三、配置VSCode工作区设置
项目级配置可覆盖全局设置，确保HLS以正确方式加载.cabal或stack.yaml文件，避免因解析失败导致功能失效。
1、在项目根目录创建 .vscode/settings.json 文件（若不存在）
2、写入以下内容：
{"haskell.serverPath": "/Users/yourname/.ghcup/bin/haskell-language-server-wrapper", "haskell.formattingProvider": "fourmolu"}
3、将路径中 yourname 替换为实际用户名；可通过终端执行 which haskell-language-server-wrapper 确认准确路径
4、保存文件后，重新打开Haskell源文件，等待右下角状态栏变为绿色就绪状态
四、验证HLS功能是否生效
功能验证需基于真实Haskell项目结构，仅打开单个.hs文件可能因缺少构建计划而无法触发完整语言服务。
1、在终端中进入项目根目录，确认存在 package.yaml 或 .cabal 文件
2、执行 cabal build 或 stack build 生成初始构建产物
3、返回VSCode，在任意模块中将光标悬停于函数名上，检查是否弹出类型签名
4、按下 Cmd+Click（macOS）或 Ctrl+Click（Windows/Linux）尝试跳转至定义位置
5、在类型错误行左侧查看是否出现红色波浪线及具体错误描述
