VS Code Haskell扩展故障：ghcide与项目GHC版本不兼容排查

• 运行环境：Windows 10 系统，VS Code 1.68.1，已安装Haskell官方语言支持插件
• 前置情况：ghcup安装脚本无错误提示但直接运行失败，ghcup官方IRC频道未提供有效解决方案，因此选择手动完成Haskell环境配置
• 手动安装HLS 1.7.0并在VS Code中指定其路径后，插件弹出如下报错：

ghcide compiled against GHC 9.2.2 but currently using 8.6.5 
This is unsupported, ghcide must be compiled with the same GHC version as the project.

• 初步排查确认：当前项目基于Stack工具构建，使用GHC 8.6.5版本，已安装的HLS内置ghcide组件基于GHC 9.2.2编译，版本不匹配。但HLS官方说明标注1.7.0版本兼容GHC 8.6.5，因此存在两个核心疑问；同时考虑过将项目GHC版本升级至9.2.2，但不熟悉Stack resolver配置规则，担心随意修改导致依赖环境损坏。

1. HLS版本匹配规则与版本确认方法 #

• HLS不存在通用的跨GHC版本二进制，官方每个正式版本发布时，都会针对所有支持的GHC版本分别编译独立的二进制包。版本强绑定的核心原因是HLS核心组件ghcide需要直接对接GHC内部API，加载项目生成的GHC接口文件实现语法检查、类型提示、代码跳转等功能，跨GHC版本的API、二进制接口格式完全不兼容，必须和项目使用的GHC版本完全一致才能正常工作，这也是用户需要感知HLS对应GHC版本的原因。
• 确认已安装HLS对应GHC版本的方法：在终端进入HLS可执行文件所在目录，执行hls --version命令，输出内容会明确标注该二进制编译时对应的GHC版本。官方发布的HLS安装包命名也会直接标注适配的GHC版本，例如文件名带ghc-9.2.2标识的安装包仅适配GHC 9.2.2，带ghc-8.6.5标识的安装包才适配GHC 8.6.5，出现当前报错就是因为安装的是适配GHC 9.2.2的HLS包。

2. 获取适配当前项目GHC版本HLS的方法 #

HLS 1.7.0确实提供对GHC 8.6.5的支持，只需要下载对应GHC 8.6.5编译的HLS 1.7.0二进制包即可，无需自行编译：

• 下载时选择文件名带ghc-8.6.5标识的Windows版本安装包，解压后在VS Code的Haskell插件设置中，将HLS路径指向该版本的hls.exe即可正常使用。
• 如果后续需要同时维护多个使用不同GHC版本的项目，可以将所有对应不同GHC版本的HLS可执行文件按hls-<GHC版本号>的规则重命名，统一放入已加入系统PATH的目录中，VS Code的Haskell插件会自动识别项目使用的GHC版本，调用对应匹配的HLS程序，无需手动切换路径。

3. 升级项目GHC版本至9.2.2的操作流程 #

如果选择将项目GHC版本从8.6.5升级至9.2.2，操作不会损坏Stack全局配置，流程如下：

• 提前备份项目根目录下的stack.yaml文件，方便出现问题时快速回退。
• GHC 9.2.2对应的稳定Stack resolver为lts-20.x系列，打开stack.yaml，将原有配置resolver: lts-14.21修改为resolver: lts-20.18即可。
• 在项目根目录执行stack setup，Stack会自动下载安装对应版本的GHC，该操作仅对当前项目生效，不会影响其他项目的配置。
• 执行stack build重新构建项目，若遇到个别依赖包版本不兼容的问题，只需在stack.yaml的extra-deps字段中添加兼容的包版本即可解决。
• 项目构建完成后，当前已安装的适配GHC 9.2.2的HLS即可正常工作。

提示：如果是生产环境项目，升级GHC大版本建议先在独立测试分支验证依赖兼容性；如果是个人练习项目，该操作完全可逆，将resolver字段改回原有值即可恢复到之前的构建环境，无需担心配置损坏。

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