GHCup¶

地址¶

https://mirrors.ustc.edu.cn/ghcup/

说明¶

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

Warning

当前的 GHCup 版本会在安装时也尝试安装 cabal，因此建议在安装 GHCup 前先手动配置 cabal 使用镜像，方法为参考文档 hackage 中的说明，修改 ~/.cabal/config。

使用方法¶

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

Note

以下命令会安装并配置 GHCup 最新版本的元数据。可查看 https://mirrors.ustc.edu.cn/ghcup/ghcup-metadata/ 目录的内容，并选择需要安装的 GHCup 版本的 yaml 文件替换以下命令中的 URL。

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

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

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-latest.yaml sh

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

$env:BOOTSTRAP_HASKELL_YAML = 'https://mirrors.ustc.edu.cn/ghcup/ghcup-metadata/ghcup-latest.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://mirrors.ustc.edu.cn/ghcup/sh/bootstrap-haskell.ps1 -UseBasicParsing))) -ArgumentList $true

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

mirrors:
  "raw.githubusercontent.com":
    authority:
      host: "mirrors.ustc.edu.cn"
    pathPrefix: "ghcup"
  "github.com":
    authority:
      host: "mirrors.ustc.edu.cn"
    pathPrefix: "ghcup/github.com"
  "downloads.haskell.org":
    authority:
      host: "mirrors.ustc.edu.cn"
    pathPrefix: "ghcup/downloads.haskell.org"

该配置使用 GHCup 的镜像功能，将官方元数据和其中引用的下载地址映射到科大源。与直接指定替代元数据文件相比，这种方式能够保留上游元数据的签名。

如果使用较旧版本的 GHCup，或需要兼容旧版配置，也可以继续使用下面的url-source 配置。该配置使用镜像站生成的 legacy metadata，不适用于需要验证上游 metadata 签名的场景：

仅用于旧配置

url-source:
  OwnSource:
    - https://mirrors.ustc.edu.cn/ghcup/ghcup-metadata/ghcup-latest.yaml

第三步（可选） ：配置 Cabal 和 Stack 使用科大源，请参考文档 hackage 和 stackage。

Warning

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

非正式频道¶

GHCup 提供预发布版本（prereleases）和交叉编译版本（cross）作为额外频道。可依需要运行以下命令启用；上述镜像配置也会应用于这些频道：

ghcup config add-release-channel prereleases
ghcup config add-release-channel cross

如果只希望使用未经 GHCup 修改的上游二进制发行版，可切换到 vanilla 频道：

ghcup config set url-source vanilla

关于使用 GHCup 安装交叉编译器的说明，请参考 GHCup User Guide 的 Cross Support 章节。

GHCup¶

地址¶

说明¶

使用方法¶

非正式频道¶

相关链接¶