本文介绍如何在类 UNIX 系统上（Linux、MacOS、FreeBSD）从零开始一步步安装 Haskell 工具链（编译器、构建工具、编辑器），特别是考虑到国内特殊网络环境，会介绍如何使用国内源。注意：
-
在 2023 年的今天，Cabal 已经取得了长足进步，因此本文将完全不涉及 Stack。
-
如果你使用 Windows，好消息是 Haskell 工具链完整支持 Windows，但超出本文范围之外。尽管如此，本文仍然适用于 WSL。
-
目前国内只有上海交大和中科大有 Haskell 工具链的完整镜像（GHCup、Hackage、Stackage）。本文采用中科大镜像，你可以手动修改命令来使用其他镜像。
本文的目标读者是对 Haskell 没有任何了解的初学者。
安装 GHCup、GHC 和其他工具
GHCup 是一个 Haskell 工具链的版本管理器。简单来说，它可用于安装不同版本的 GHC、Cabal、HLS 等工具。
准备工作
GHCup 是一个近期出现的工具，因此国内目前只有中科大和上海交大有镜像。在安装 GHCup 之前，我们要做一件额外的工作，创建 ~/.cabal 目录，并创建 ~/.cabal/config 文件，填入如下内容：
repository mirrors.ustc.edu.cn
url: https://mirrors.ustc.edu.cn/hackage/
secure: True
这是因为 GHCup 在安装 Cabal 时会进行初始化（会下载一个 100MB 的文件），但此时我们还没有替换 Hackage 源！这一步首先替换 Hackage 源。之后安装过程就会如丝般顺滑。
执行安装
在终端中运行如下命令：
curl --proto '=https' --tlsv1.2 -sSf https://mirrors.ustc.edu.cn/ghcup/sh/bootstrap-haskell | BOOTSTRAP_HASKELL_YAML=https://mirrors.ustc.edu.cn/ghcup/ghcup-metadata/ghcup-0.0.7.yaml sh
（是的，一行。）
很快，你会看到如下界面：
**安装过程请仔细阅读所有提示。**针对三个问题，下面是我的推荐：
-
**是否将 ghcup 目录加入 PATH？**直接回车接受默认值，如果你在看这篇文章，说明你一定会用到。
-
**是否安装 Haskell Language Server？**安装与否均可，之后想装也很容易。这里输入 Y 安装（你大概是希望使用更高级的 IDE 功能的）。
-
**是否安装 Stack？**输入 N，不安装。
之后一路回车，GHCup 将下载安装推荐版本的 GHC 和 Cabal，并完成初始化。（截至本文写作时，GHC 版本是 8.10.7）。结束后，你会看到一大片提示，请仔细阅读所有输出。这里必做的事情是设置当前 shell 的 PATH （或者重启一下 shell 也行）：
source ~/.ghcup/env
测试安装
搞定！你已经可以用起来 Haskell 了。
$ ghc --version
The Glorious Glasgow Haskell Compilation System, version 8.10.7
$ cabal --version
cabal-install version 3.6.2.0
compiled using version 3.6.2.0 of the Cabal library
$ ghci
GHCi, version 8.10.7: https://www.haskell.org/ghc/ :? for help
Prelude> putStrLn "Hello, Haskell!"
Hello, Haskell!
Prelude>
Leaving GHCi.
配置 GHCup 源
我们上面用了环境变量临时修改了 GHCup 元数据地址，这里我们把镜像写到配置里让国内源永久生效。修改 ~/.ghcup/config.yaml（如不存在就创建），添加如下内容：
url-source:
OwnSource: https://mirrors.ustc.edu.cn/ghcup/ghcup-metadata/ghcup-0.0.7.yaml
GHCup 的用法
ghcup 有一个很好用的命令叫 tui，所有 ghcup 的操作均可以从这里完成，运行 ghcup tui 会显示如下界面。
其中打双对勾的是当前选中版本。比如你安装了 GHC 9.2.1 和 GHC 8.10.7 两个版本，但是目前选中的是 8.10.7，那么运行 ghc 命令会调用 8.10.7 版本而非 9.2.1 版本。你可以安装多个版本，但一次只能选中一个版本（用 s 键选中别的版本）。好了，剩下的命令都顾名思义，自己试试即可。
如果想安装 HLS 的话，随时可以从这里安装。
配置编辑器
本文的重点不是配置编辑器，下面只给出一些提示。请参阅其他资料（尤其是相应插件自己的文档）了解如何配置、如何使用。
Visual Studio Code
Visual Studio Code 是目前最流行的代码编辑器之一，Haskell 语言服务器则为 LSP 提供了较好的支持，两者相得益彰。只需在扩展市场中搜索名为 Haskell 的扩展并安装即可。
之后，任意打开一个 .hs 文件，Visual Studio Code 就会自动调用 GHCup 已经安装的 HLS，可以充分体验 Haskell 的 IDE 编辑体验了！（如果 VSCode 提示你要下载 HLS，请下转故障排除章节。）
恭喜，至此你已经完成配置了 2023 年最先进的 Haskell 工具链+编辑环境！尽情享受吧！
Emacs
Emacs 默认没有 Haskell 代码高亮，但可以安装 haskell-mode。它的功能非常丰富，推荐阅读其文档。比如一个很有用的命令是 haskell-process-load-or-reload ，可以用来快速打开一个 ghci 并载入当前文件。
如果想要使用 HLS：
-
先手动通过 ghcup 安装 HLS。
-
再安装 lsp-mode、lsp-haskell。
That’s all!
Vim 和 Neovim
vim 原生支持 Haskell 的代码高亮。要与 HLS 集成，可使用 coc.nvim。
Cabal 应急生存手册
使用 Haskell 时，强烈建议首先创建一个项目。这是因为 Cabal 让使用第三方库非常方便。Cabal 有一个不错的使用指南，值得收藏：
创建项目
$ mkdir my-first-haskell-project
$ cd my-first-haskell-project
$ cabal init # 在当前目录下初始化一个 Cabal 项目
Guessing dependencies...
Generating LICENSE...
Warning: unknown license type, you must put a copy in LICENSE yourself.
Generating CHANGELOG.md...
Generating app/Main.hs...
Generating my-first-haskell-project.cabal...
Warning: no synopsis given. You should edit the .cabal file and add one.
You may want to edit the .cabal file and add a Description field.
$ tree .
.
├── CHANGELOG.md
├── app
│ └── Main.hs
└── my-first-haskell-project.cabal
1 directory, 3 files
可以看到，Cabal 创建了 3 个文件。其中 CHANGELOG.md 是用来记录版本更新内容的，对初学者来说不用关心。
增加第三方依赖
打开 .cabal 文件，除去基本的项目信息外，有一个 executable 段落：
executable my-first-haskell-project
main-is: Main.hs -- 入口文件名
build-depends: base ^>=4.14.3.0 -- 依赖
hs-source-dirs: app -- 代码目录
default-language: Haskell2010 -- 默认语言
其中， ^>= 对 base （Haskell 标准库） 的版本增加了限制。对学习者来说，可以忽视这些限制（直接去掉版本限制）。下面我们增加 time 这个库为一个依赖：
executable my-first-haskell-project
main-is: Main.hs
build-depends: base, time -- 这里添加了 time 库
hs-source-dirs: app
default-language: Haskell2010
然后，就可以在代码文件 app/Main.hs 中使用了：
module Main where
import Data.Time.LocalTime -- 来自 time 库
main :: IO ()
main = do
now <- getZonedTime
print now
（补充说明：Cabal 在编译时会自动求解一套互相兼容的包的版本，因此不写版本限制对学习者来说最方便，出问题的概率小了很多。但同时要注意这是不好的开发实践，在发布软件时最好先使用 cabal gen-bounds 命令生成兼容的版本范围。尽管不写版本范围让可行解的范围大了不少，但仍然有可能出现不兼容问题——会输出大量令人生畏的报错信息——这多数情况是因为你的某个依赖实在是太旧了，最好换一个新的同类包。）
编译、运行和 REPL
$ cabal build # 编译
[一大堆输出]
[1 of 1] Compiling Main [一堆输出]
Linking ..../my-first-haskell-project
$ cabal run # 运行
[cabal run 会自动调用 cabal build，所以这里可能是 Up to date 也可能是和 cabal build 一样的一大堆输出]
2022-01-11 01:38:32.87706 CST
$ cabal repl
[一大堆输出]
*Main> # ghci，但自动载入 Main 模块，并且可以自由用任何第三方依赖里的模块
Cabal 在编译时会自动从 Hackage 上下载并构建第三方依赖。因此你可以自由地在 Hackage 上找自己感兴趣的包，然后加到项目依赖里来实验。比如下面这些好玩的包，可以试试看！
-
gloss, 2D 图形库。
-
reanimate, 类似 manim 的动画库。首页有很多酷炫例子。
-
gi-gtk-declarative, GUI 库。
-
inline-r, 与 R 语言无缝协作。
-
Chart, 绘制 2D 图表。
-
accelerate, 硬件加速的数组运算库，可以编译到 GPU 上运行！
-
ad, 自动微分。
-
等等等等……
Hackage 上有很多有趣的包，现在都是你的了。
故障排除
如何彻底卸载？如何彻底重新安装？
rm -rf ~/.cabal ~/.ghcup ~/.ghc
VSCode 提示我要下载 HLS，但我在 GHCup 那里已经下载过了？
有如下原因：
-
你没有使用 GHCup 安装 HLS。现在去安装一下？如果还不行，再看下面的。
-
你没有添加 GHCup 的路径到 PATH 中。如果始终不行，参考下面的配置。
在 Haskell 扩展页面，点击页面上的小齿轮打开扩展配置。
-
找到 “Haskell: Server Executable Path” 配置项。
-
输入
~/.ghcup/bin/haskell-language-server-wrapper。 -
重启 VSCode。
这时候重新打开文件应该就可以正确调用到 GHCup 安装的 HLS 上了。
编辑器提示我 HLS 启动失败，怎么回事？
最可能的原因是你启用了 HLS 目前不支持的新版本 GHC。如果想使用 HLS，请务必在 ghcup tui 中选中一个有 hls-powered 标记的 GHC 版本（比如 9.0.1, 8.10.7 等）。
其他环境错误
-
Mac 上安装时，若报错信息中有
configure字样，是因为没有安装 Xcode Command Line Tools。 -
如果步骤“执行安装”中运行命令后提示类似
curl: command not found，需要安装curl。Linux 下命令为：sudo apt install curl。 -
在 Linux 下可能需要额外安装一些包。以 Linux Mint 20.3（同 Ubuntu 20.04）为例：执行
sudo apt install build-essential libgmp-dev libncurses5-dev libncursesw5-dev来安装 gcc、gmp 库、ncurses 库。其他发行版可参照之。
修订记录
-
2023-07-09: 少量格式和字句修正；「2022」更新到「2023」。
-
2022-09-15: 将 ghcup metadata 版本升级至 0.0.7。