GHCup 使用帮助 - MirrorZ Help

GHCup 是一种用于安装 Haskell 的工具，它使得用户可以轻易地在 GNU/Linux、macOS 和 FreeBSD 上安装特定版本的 ghc，并从零开始搭建好一个全新的 Haskell 开发环境（包括 cabal 与 HLS 支持）。

GHCup 类似 Rustup，可以用于安装 Haskell 工具链。建议搭配 Hackage 和 Stackage 源使用。

USTC

该节内容仅适用于 USTC 及通过类似方式同步 GHCup 的站点。

使用方法

参考如下步骤可安装完整的 Haskell 工具链。

注意，以下命令会安装并配置 GHCup 0.0.8 版本的元数据。可查看以下目录的内容，并选择需要安装的 GHCup 版本的 yaml 文件替换以下命令中的 URL。

https://(Loading...)/ghcup-metadata/

第一步（可选） ：使用镜像源安装 GHCup 本体。如已经安装 GHCup，可跳到下一步。

Linux, FreeBSD, macOS 用户：在终端中运行如下命令

# Linux, FreeBSD, macOS 用户：在终端中运行如下命令
curl --proto '=https' --tlsv1.2 -sSf https://(Loading...)/sh/bootstrap-haskell | BOOTSTRAP_HASKELL_YAML=https://(Loading...)/ghcup-metadata/ghcup-0.0.8.yaml sh

Windows 用户：以非管理员身份在 PowerShell 中运行如下命令

$env:BOOTSTRAP_HASKELL_YAML = 'https://(Loading...)/ghcup-metadata/ghcup-0.0.8.yaml'
Set-ExecutionPolicy Bypass -Scope Process -Force;[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072;Invoke-Command -ScriptBlock ([ScriptBlock]::Create((Invoke-WebRequest https://(Loading...)/sh/bootstrap-haskell.ps1 -UseBasicParsing))) -ArgumentList $true

第二步 ：配置 GHCup 使用科大源。编辑 ~/.ghcup/config.yaml 增加如下配置：

url-source:
  OwnSource: https://(Loading...)/ghcup-metadata/ghcup-0.0.8.yaml

第三步（可选） ：配置 Cabal 和 Stack 使用镜像源，请参考文档 Hackage 帮助和 Stackage 帮助。

镜像站 GHCup 源仅支持较新的 GHCup 版本（元数据格式版本仅支持 0.0.6 及以上）。如果你使用的 GHCup 版本比较旧，请参考上述步骤安装新版本 GHCup。

预发布版本

使用预发布频道可以安装尚未正式发布的测试版本。要启用预发布源，将 ~/.ghcup/config.yaml 文件中 url-source 一节修改如下：

url-source:
  OwnSource:
    - https://(Loading...)/ghcup-metadata/ghcup-0.0.8.yaml
    - https://(Loading...)/ghcup-metadata/ghcup-prereleases-0.0.8.yaml

SJTUG

该节内容仅适用于 SJTUG 及通过类似方式同步 GHCup 的站点。

使用说明

创建 ~/.ghcup/config.yaml 并输入以下内容：

url-source:
  OwnSource: https://(Loading...)/yaml/ghcup/data/ghcup-0.0.8.yaml

如果您尚未安装 ghcup，请在完成以上步骤后，于终端中执行以下指令（请不要以 root 用户执行），随后跟随屏幕上的指引完成安装。

如果您运行的是 Linux, macOS (Intel), FreeBSD 或 WSL，请执行：

curl --proto '=https' --tlsv1.2 -LsSf https://(Loading...)/script/install.sh | sh

如果您运行的是 macOS (Apple 芯片) 请执行：

curl --proto '=https' --tlsv1.2 -LsSf https://(Loading...)/script/install.sh | arch -x86_64 /bin/bash

故障排除

ghcup 出现形如 [ Error ] JSON decoding failed with: AesonException 的错误

这可能是由于本机 ghcup 版本与配置文件版本不匹配造成。 ghcup 于 0.1.15.1 版本前使用 0.0.4 版本的配置文件，此版本及之后的版本使用 0.0.5+ 版本的配置文件。请尝试将 config.yaml 中的 ghcup-0.0.8.yaml 改为 ghcup-0.0.4.yaml （抑或反之）后重试。

请注意，ghcup 上游倾向于仅更新最新版本配置文件中的内容，当版本发生变化后请及时更新配置文件版本。

通过 ghcup 安装软件包时出现 Error: Download failed ... 错误

这一错误可能是由于您的 ghcup 版本过老，使用的配置文件已经长久未更新，其中包含的软件包版本过旧所致。我们将尽力保留旧版本的软件包，但当存储空间不足时，可能随时删除旧文件。本镜像站仅保证同步最新版本配置文件中包含的软件包。

当出现上述现象时，请首先尝试更新 ghcup 的版本，并根据 故障排除 1 的指示修改配置文件。若 ghcup 已无法更新，可以尝试删除 ~/.ghcup 整个文件夹（这一操作将删除 ghcup 以及所有通过 ghcup 安装的软件），并根据 使用说明 重新安装最新版本的 ghcup。

若完成以上步骤后问题仍未解决，请至此处向 SJTUG 反馈 BUG。

其他配置

XDG 支持

参考 GHCup xdg-support。

对于 Linux、FreeBSD、macOS 用户，如果想要让 GHCup 遵循 XDG 规范，可以使用 GHCUP_USE_XDG_DIRS 变量，例如：

export GHCUP_USE_XDG_DIRS=1

还可以将上述内容写入 ~/.profile 等文件中。

使用 GHCUP_USE_XDG_DIRS 后，GHCup 配置目录将由默认的 ~/.ghcup 变成 ~/.config/ghcup；而二进制目录会使用 ~/.local/bin，需要将该目录加入 PATH 才能够正常使用 GHCup 安装的 GHC 以及其他工具。

export PATH=$HOME/.local/bin:$PATH

安装目录变更

参考 GHCup env-variables。

对于 Windows 用户或不想使用 XDG 目录的 Linux、FreeBSD、macOS 用户，可以使用 GHCUP_INSTALL_BASE_PREFIX 来更改默认安装路径。默认安装路径，对 Windows 用户而言是 C:\ghcup，而对于 Linux、FreeBSD、macOS 用户而言是 $HOME/.ghcup。

如果想要将 GHCup 的安装目录放到某一个特定目录下，例如 ~/sdk：

Windows 用户

可以在终端使用如下方法：
```
$env:GHCUP_INSTALL_BASE_PREFIX = $env:USERPROFILE/sdk
```
或使用系统设置添加该环境变量。
Linux、FreeBSD、macOS 用户

可以在终端使用如下方法：
```
export GHCUP_INSTALL_BASE_PREFIX=$HOME/sdk
```
还可以将上述内容写入 ~/.profile 等文件中。

MSYS2 设置

参考 GHCup env-variables。

对于 Windows 用户，如果系统中已经安装了 MSYS2 环境，则可以使用 GHCUP_MSYS2 来指定想要让 GHCup 使用的 MSYS2 环境。如果不指定使用的 MSYS2 环境，则会默认新安装一个 MSYS2 环境，并且使用新安装的 MSYS2 环境。