Haskell 作为一个冷门语言,并没有一个简单好用傻瓜式的 IDE。所以笔者记录了自己搭建环境的过程,希望对大家有所帮助。
准备工作
- 一个好的网络环境,至少与 GitHub 保持通畅连接
- Homebrew
开发环境的搭建
编译器(GHC)、解释器(GHCI)等 Haskell 工具链
在笔者踩过无数坑之后,无脑推荐Haskell Stack,喜欢挑战的读者可以自行尝试使用 GHC+GHCI+Cabal开发环境
brew install haskell-stack
编辑器
目前主流的编辑器有 vim, emacs, sublime, atom, visual studio code 等,笔者平日开发中只在修改配置文件或者替换某个字符串时用到它们故先按下不表。
IDE
因为宇宙最强 IDE——Visual Studio在 Mac 上发力较晚并表现不佳,故笔者建议使用IntelliJ IDEA(虽说笔者非常讨厌 Java 这门语言,但是不得不承认 Java 写出来的工具还是有不少好用的)
HaskForce
IntelliJ IDEA 有两个第三方插件提供了对 Haskell 的支持,笔者建议使用评分较高的HaskForce,目前这款插件已经无人维护(存疑,但也侧面反映了 Haskell 社区的现状)
-
安装
- 在 IntelliJ IDEA 中按下 ⌘ + , 进入偏好设置界面
Plugins > Browse repositories > HaskForce
-
使用
由于 HaskForce 插件自身的局限性,需要在终端中通过 Haskell Stack 创建项目。stack new 项目名称 模版名称 路径(默认当前路径)
cd 项目名称
stack setup
stack build
注意如果在创建项目中提示参数不足的警告,可以在~/.stack/config.yaml 中配置
templates:
params:
author-name: your-name
author-email: your-email
copyright: "Copyright (c) 2018 0x11901"
github-username: "0x11901"
category: categories
不建议在此写死模版名称,如果不是很确定要用什么模版,可以在新建项目时传 simple
- 使用 IntelliJ IDEA 导入创建的 Haskell Stack 项目
- 路径选择项目的根目录,注意一下是不是选择了 Stack 模块
- 然后一直下一步
- 配置下 configurations
> add > Haskell Stack Run > Executable: 项目名称
- Executable 一定要填写
- 点击 run 就能运行你的 Haskell 程序了!
相关工具
如果仅仅只有这些虽然就能愉快的编码了,但是笔者认为是完全不够的。毕竟如果没有代码格式化工具和静态代码分析工具,笔者是不会写代码的。所以怎么能少了这些呢!!!
刚好 HaskForce 整合了 hlint, ghc-mod, hindente 等相关 Haskell 工具,可以很好地与 IntelliJ IDEA 结合。它们的安装也十分简单,可以直接使用 Haskell Stack 安装,当然 hlint 也可以使用 Homebrew 安装,不过笔者建议使用统一的安装方式方便将来管理。
stack install hlint hindente stylish-haskell
其中 ghc-mod 的安装值得特别说一下,目前新建的 Haskell Stack 工程默认的 resolver 是 lts-11.6 , 其 GHC 的版本号是 8.2.2 , 而 ghc-mod 的主工程由于技术问题一直没有支持这套环境,所以想要成功编译出来是很麻烦的。所以如果大家想使用这款令人愉悦的黑客工作,可以按照下列步骤来编译。
1. 推荐建立一个独立的目录来存储接下来要使用的文件,编译完成后即可删除
2. cd 你刚刚建的目录
3. git clone https://github.com/DanielG/ghc-mod.git -b ghc802
4. git clone https://github.com/DanielG/cabal-helper.git
5. cd ghc-mod ; touch stack.yaml
因为通过 Haskell Stack 来编译 ghc-mod 需要配置一个 stack.yaml , 所以用你最喜欢的编译器打开 stack.yaml 并写上下面的内容:
resolver: lts-11.6 # current resolver
packages:
- location: .
- location: ./core # seems like ghc-mod-core got integrated
- location: ../cabal-helper
extra-dep: true
extra-deps:
- extra-1.6.6 # escapeJSON was missing with 1.5.3
- monad-journal-0.7.2
- optparse-applicative-0.13.2.0
- unix-compat-0.4.3.1
- either-4.4.1.1
- cabal-plan-0.3.0.0
flags: {}
extra-package-dbs: []
allow-newer: true # so it builds / too lazy to pinpoint exact versions
现在在当前目录使用 stack install
命令即可正常编译出 ghc-mod 与 ghc-modi 并会被放在 ~/.local/bin
目录下,你可以将这个目录加入 shell 的环境变量中也可以把它们移到已经加到 shell 的环境变量的目录下。
最后打开 IntelliJ IDEA 的进入偏好设置界面界面,找到 Haskell Tools 一栏,然后找到你想要使用的工具,点击 Auto Find 按钮然后确认,就能在 IntelliJ IDEA 使用这些工具了!
Haskell IDE Engine
笔者最近在 GitHub 上发现了这个新项目,相对于 HaskForce 无人维护的状态,该项目正在如火如荼地开发中。正如该项目介绍所说,这款 Haskell 引擎笔者分析集成了上述所说的所有工具,而且安装配置更加傻瓜化。考虑到维护性,笔者建议考虑配置 Haskell 环境的同学应使用这个解决方案。
Haskell IDE Engine 与 Visual Studio Code 集成
从 Haskell IDE Engine 的介绍中可以看出,作者是按照“编辑器 + HIE”这种模式来设计的,故这次笔者尝试了 Haskell IDE Engine + Visual Studio Code 的组合。选择 Visual Studio Code 的原因主要是免费,毕竟笔者很穷。
他们的集成也很简单:
先从 VSCode 市场 安装 Haskell Language Server ,然后再自行编译 HIE。
可以根据自己所用的 GHC 版本选择编译 HIE , 但是根据 Haskell Language Server 的说法,建议全部编译,故笔者选择全编译:
git clone https://github.com/haskell/haskell-ide-engine --recursive
cd haskell-ide-engine && make build-all
- 需要你的 Haskell Stack version >= 1.7.1
- 一个流畅的网络
编译成功后二进制文件会放在 ~/.local/bin
,建议将这个路径加入到 $PATH 中。
最后只需要打开 VSCode 的偏好设置,在 JSON 中配置一下即可,具体可以看一下 Haskell Language Server 的文档,基本上默认的配置就可以,但是也有 "languageServerHaskell.useHieWrapper": true
字段可以选择打开,如果你没有把 HIE 的二进制文件加入 $PATH 中,还需要配置 "languageServerHaskell.hieExecutablePath": ""
字段。
现在就能使用 VSCode 愉快地撸码了。
后记
Haskell IDE Engine 还支持很多编辑器,适应性很广。虽说现在用起来不如 HaskForce + IntelliJ IDEA 的组合,但是已发展的眼光来看,未来应该是 Haskell IDE Engine 占主流地位的。所以笔者建议大家都可以试试,总之目前用着还是比较满意的,以上。