工作区(workspace)是磁盘上的一组 modules。
参见:使用模块
为什么重要
工作区把多个本地模块(最典型的是你正在改的主题)接到一起开发:用 .work 文件列出模块路径,再通过配置项 workspace 或环境变量 HUGO_MODULE_WORKSPACE 启用,构建就直接用本地目录而不是模块缓存里的版本。它的坑全在「这次构建到底用了哪一份」:没启用工作区,改了本地主题站点也不变;启用了却还开着 vendor,本地改动依旧不热重载,需要按文档加 --ignoreVendorPaths "**"。排查时先确认工作区是否生效,再看模块配置里的 replace。
延伸阅读:使用模块、模块简介