如何在构建Haddock时排除依赖？如何为特定包构建Haddock文档？

我之前也碰到过这个困扰——跑stack haddock webservice的时候，居然连所有依赖包的文档都一起构建，慢得要死！后来摸索出几个实用的解决办法，分享给你：

一、排除所有依赖包的文档构建 #

默认情况下，Stack会为了生成交叉引用，自动构建所有依赖包的Haddock文档。如果不需要这部分内容，只需要在命令里加上--no-deps参数，就能跳过所有依赖的文档生成：

stack haddock --no-deps webservice

这个参数会让Stack只专注处理你指定的webservice包，速度会快很多，尤其当你的项目依赖较多时效果明显。

二、仅为特定包构建文档（含精细预览） #

如果你的项目包含多个本地包，只想为其中某一个（比如webservice）构建文档，上面的命令其实已经实现了——指定包名加上--no-deps，就只会处理这个特定的本地包。

要是你不确定命令会处理哪些包，可以先加上--dry-run参数做个预览，避免白跑一趟：

stack haddock --dry-run --no-deps webservice

如果偶尔需要保留部分依赖的文档（而不是全排除），可以用--haddock-arguments配合Haddock原生参数做更精细的控制，但这个场景比较少见，一般--no-deps就足够解决大部分需求了。

内容的提问来源于stack exchange，提问作者Saurabh Nanda