Haskell安装 #

一、安装方式概述 #

Haskell有多种安装方式,推荐使用以下工具:

工具 描述 适用场景
GHCup Haskell工具链安装器 推荐,官方推荐方式
Stack 项目构建工具 项目开发
GHC Glasgow Haskell Compiler 编译器
Cabal 包管理工具 依赖管理

二、使用GHCup安装(推荐) #

GHCup是Haskell官方推荐的安装工具,可以管理GHC、Cabal、Stack等。

2.1 Linux/macOS安装 #

打开终端,执行以下命令:

bash
curl --proto '=https' --tlsv1.2 -sSf https://get-ghcup.haskell.org | sh

安装过程中会询问:

  1. 是否安装Haskell Language Server(推荐安装)
  2. 是否安装Stack(可选)
  3. 是否添加到PATH(推荐同意)

2.2 Windows安装 #

使用PowerShell安装:

powershell
Set-ExecutionPolicy Bypass -Scope Process -Force;[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072;try { Invoke-Command -ScriptBlock ([ScriptBlock]::Create((Invoke-WebRequest https://www.haskell.org/ghcup/sh/bootstrap-haskell.ps1 -UseBasicParsing).Content)) -ArgumentList $true } catch { Write-Error $_ }

或者下载安装器:

  1. 访问 https://www.haskell.org/ghcup/
  2. 下载Windows安装器
  3. 运行安装程序

2.3 验证安装 #

安装完成后,验证各组件:

bash
# 检查GHCup版本
ghcup --version

# 检查GHC版本
ghc --version

# 检查Cabal版本
cabal --version

# 检查Stack版本(如果安装了)
stack --version

三、GHCup常用命令 #

3.1 版本管理 #

bash
# 列出可用的GHC版本
ghcup list

# 安装指定GHC版本
ghcup install ghc 9.4.8

# 设置默认GHC版本
ghcup set ghc 9.4.8

# 安装Cabal
ghcup install cabal 3.10.2.1

# 设置默认Cabal版本
ghcup set cabal 3.10.2.1

3.2 工具安装 #

bash
# 安装HLS(Haskell Language Server)
ghcup install hls

# 安装Stack
ghcup install stack

# 安装常用工具
ghcup install haddock  # 文档生成工具
ghcup install hlint    # 代码检查工具

3.3 更新与维护 #

bash
# 更新GHCup本身
ghcup upgrade

# 更新所有工具
ghcup upgrade

# 清理旧版本
ghcup gc

四、使用Stack安装 #

Stack是另一种流行的Haskell构建工具。

4.1 Linux/macOS安装 #

bash
curl -sSL https://get.haskellstack.org/ | sh

4.2 Windows安装 #

下载安装器:

  1. 访问 https://docs.haskellstack.org/en/stable/install_and_upgrade/
  2. 下载Windows安装器
  3. 运行安装程序

4.3 验证安装 #

bash
stack --version

五、手动安装GHC #

如果需要手动安装GHC:

5.1 Linux #

bash
# Ubuntu/Debian
sudo apt update
sudo apt install ghc cabal-install

# Fedora
sudo dnf install ghc cabal-install

# Arch Linux
sudo pacman -S ghc cabal-install

5.2 macOS #

bash
# 使用Homebrew
brew install ghc cabal-install

# 或使用MacPorts
sudo port install ghc cabal-install

5.3 Windows #

从官网下载安装:

  1. 访问 https://www.haskell.org/ghc/
  2. 下载Windows二进制包
  3. 解压并添加到PATH

六、IDE配置 #

6.1 VS Code配置 #

  1. 安装VS Code
  2. 安装Haskell扩展
  3. 确保HLS已安装
bash
# 安装HLS
ghcup install hls

6.2 IntelliJ IDEA配置 #

  1. 安装IntelliJ-Haskell插件
  2. 配置GHC路径
  3. 启用类型检查

6.3 Emacs配置 #

使用haskell-mode:

elisp
(require 'haskell-mode)
(add-hook 'haskell-mode-hook 'haskell-indent-mode)
(add-hook 'haskell-mode-hook 'interactive-haskell-mode)

七、项目初始化 #

7.1 使用Cabal #

bash
# 创建新项目
mkdir my-project
cd my-project
cabal init

# 项目结构
-- my-project.cabal
-- app/Main.hs
-- src/Lib.hs

7.2 使用Stack #

bash
# 创建新项目
stack new my-project

# 项目结构
-- my-project.cabal
-- app/Main.hs
-- src/Lib.hs
-- stack.yaml

八、常见问题 #

8.1 PATH配置问题 #

如果命令找不到,检查PATH:

bash
# Linux/macOS 添加到 ~/.bashrc 或 ~/.zshrc
export PATH="$HOME/.ghcup/bin:$PATH"
export PATH="$HOME/.cabal/bin:$PATH"

8.2 权限问题 #

Linux/macOS上可能需要权限:

bash
# 确保目录权限正确
sudo chown -R $(whoami) ~/.ghcup

8.3 网络问题 #

如果下载慢,可以配置镜像:

bash
# 设置Hackage镜像
cabal user-config init
# 编辑 ~/.cabal/config

8.4 Windows特定问题 #

Windows上可能遇到的问题:

  • 长路径限制:启用长路径支持
  • 防火墙:允许GHC和Cabal访问网络
  • 杀毒软件:添加排除目录

九、安装验证 #

创建测试文件验证安装:

haskell
-- test.hs
main :: IO ()
main = putStrLn "Haskell安装成功!"

编译运行:

bash
# 编译
ghc test.hs -o test

# 运行
./test

# 或直接运行
runhaskell test.hs

十、总结 #

Haskell安装要点:

  1. 推荐GHCup:官方推荐,管理方便
  2. 安装HLS:获得IDE支持
  3. 配置PATH:确保命令可用
  4. 选择构建工具:Stack或Cabal

安装完成后,让我们进入下一章,编写第一个Haskell程序。

最后更新:2026-03-27