企业官网建设流程全解析

HaskellR快速开始指南：Stack+Nix三步搭好R互操作环境，跨平台安装一次讲透

【免费下载链接】HaskellRThe full power of R in Haskell.项目地址: https://gitcode.com/gh_mirrors/ha/HaskellR

HaskellR 让你用 Haskell 无缝调用 R 语言，反之亦然——把 R 在统计分析、机器学习、数值计算上的完整能力直接嵌入 Haskell 程序。本指南将带你用Stack + Nix三步搭好 HaskellR 的 R 互操作环境，并一次性讲透 Windows、Linux、macOS 跨平台安装的关键差异。

上图就是典型的 HaskellR 应用场景：在 Haskell 中调用 R 的统计与绘图函数，生成专业的分析图表。下面开始动手。

一、HaskellR 是什么？适合谁用？

HaskellR 由三部分组成：

它适合想用 Haskell 做工程化开发、同时又离不开 R 生态（ggplot2、stats、机器学习包）的数据工程师和科研用户。核心用法很简单：用[r| ... |]把 R 代码"夹"进 Haskell 里执行。

二、三步搭好 Stack + Nix 构建环境

第 1 步：获取代码

git clone https://gitcode.com/gh_mirrors/ha/HaskellR cd HaskellR

项目默认使用 Stack 管理构建，工作区配置在 stack.yaml 中，包含examples、H、IHaskell、inline-r四个包。仓库还附带了 LTS-21 / LTS-24 等多套 stack-lts-24.yaml 配置，可按你本机的 GHC 版本灵活切换。

第 2 步：用 Nix 准备系统依赖（推荐）

构建 HaskellR 需要系统级的 R 解释器、zeromq、zlib 等依赖。手动安装容易踩坑，项目提供了现成的 Nix 环境：

stack build --nix

只需给所有 stack 命令加上--nix参数，Nix 就会在本地沙箱里自动装好全部系统依赖，不污染你的全局文件系统，也是 Docker 之外的跨平台替代方案。相关配置见 shell.nix，其中已预装 R、ggplot2、ipython 等包。

第 3 步：一次性构建、测试、生成文档

stack build --nix --test --haddock --bench

一条命令完成编译、跑测试套件、生成 API 文档和基准测试，非常适合第一次验证环境是否搭对。

三、启动 H：两行命令体验 R 互操作

构建完成后，直接运行交互环境：

H

H是一个精心配置的 GHCi 封装，启动时会自动加载 R 解释器。进入后你可以自由混写两种语言：

H> it <- [r| append(c(1,2,3), c(4,5,6)) |] H> printR it [1] 1 2 3 4 5 6

几个新手必知的约定：

• [r| ... |]：括号内的内容会被发送给 R 解析并求值，结果存入 Haskell 变量
• _hs后缀：在 R 代码中引用 Haskell 变量时，变量名加_hs后缀（如x_hs + y_hs）
• p/printR：把 R 端结果打印出来
• <<-：超级赋值，跨多次 R 调用保留全局状态

更多交互技巧见 docs/docs/using-h.md，还有现成的非线性最小二乘示例可直接运行：

cd examples/nls H -- -ghci-script nls.H

四、跨平台安装关键差异（一次讲透）

不同平台上最容易出问题的就是"系统如何找到 R 的动态库"，对照下表即可自查：

💡 只要系统依赖这一步用--nix，以上三个平台的差异会被 Nix 环境自动抹平，这也是官方推荐它的原因。

五、进阶：Jupyter Notebook 里的 R 互操作

如果你更喜欢 Notebook 工作流，HaskellR 内置了 IHaskell 内核，可以像下面这样在 Jupyter 里直接加载 R 包、绘制图表（官方教程：IHaskell/examples/tutorial-ihaskell-inline-r.ipynb）：

In [10]: [r| require("ggplot2") |]

在 Notebook 中遇到栈溢出报错时，在~/.ihaskell/rc.hs里加一行:set -fno-ghci-sandbox即可解决。

六、安装翻车自救清单（FAQ 精华）

完整排障思路见 docs/docs/faq.md。

七、跑一个最小示例验证成功

最后用 FFT 示例做端到端验证——它展示了 Haskell 调用 R 函数并取回结果的最小完整闭环（源码：examples/fft/Main.hs）：

r_fft :: [Complex Double] -> R s [Complex Double] r_fft nums = do R.dynSEXP <$> [r| fft(nums_hs) |]

构建运行它，看到正确的傅里叶变换结果输出，说明你的 HaskellR R 互操作环境已经 100% 就绪 🎉

总结

• 三步走：git clone→stack build --nix→stack build --nix --test --haddock --bench
• 跨平台核心：让 Nix 统一管理 R 系统依赖，Windows 只需额外确认PATH里有R.dll
• 上手入口：终端用H，Notebook 用 IHaskell 内核，示例代码都在 examples/ 目录

掌握以上步骤，你就拥有了在 Haskell 里调用整个 R 生态的完整能力。祝编码愉快！

【免费下载链接】HaskellRThe full power of R in Haskell.项目地址: https://gitcode.com/gh_mirrors/ha/HaskellR