VS Code中Haskell Language Server：跳转至定义失效，但peek可用

以下是针对该问题的具体排查和解决步骤：

• 检查项目配置文件的依赖完整性
  确保你的.cabal/cabal.project或stack.yaml已正确声明目标函数所在的依赖包，且该包已通过cabal build或stack build安装到本地环境。若依赖仅存在于Hackage但未本地安装，HLS能通过类型推断识别函数，但无法定位到定义文件。可运行cabal check或stack build --dry-run验证配置文件的语法和依赖合法性。

• 重启HLS并刷新项目上下文
  在VS Code命令面板（Ctrl+Shift+P / Cmd+Shift+P）执行Haskell: Restart Haskell Language Server，强制HLS重新解析所有模块与依赖。如果是Stack项目，需确保VS Code的HLS配置使用Stack环境：在设置中将haskell.serverExecutablePath设为stack exec -- hls。

• 确认本地模块的导出范围
  若目标函数是自定义本地模块的内容，检查模块头部的导出列表是否包含该函数。比如模块定义为module MyUtils (utilityFunc) where，若未将utilityFunc加入导出列表，HLS能识别类型但无法跳转至定义（定义不在公开访问范围内）。

• 核对第三方包的版本一致性
  对于第三方包中的函数，确认本地安装版本与项目配置文件指定的版本完全一致。运行cabal list <package-name>或stack list-dependencies查看本地已安装版本，若版本不匹配，执行cabal update && cabal build或stack update && stack build同步依赖。

• 清理本地构建缓存
  旧缓存可能导致HLS无法读取最新定义信息：

  • Cabal项目：删除dist-newstyle目录，再执行cabal build
  • Stack项目：删除.stack-work目录，执行stack clean && stack build

• 启用HLS定义跳转插件
  在VS Code的settings.json中添加以下配置，确保核心功能启用：

  "haskell.plugin.ghcide-hover-and-symbols.enabled": true,
  "haskell.plugin.definition.enabled": true
  

内容的提问来源于stack exchange，提问作者Kvothe