Windows下Hugo出现short read in readEvents()错误导致站点持续自动重建

你遇到的是Hugo v0.82.x版本在Windows环境下的已知缺陷，该版本引入的fsutil文件监听逻辑存在空指针漏洞，当监听的静态文件数量较多时，会触发short read in readEvents()报错和panic日志，误判文件持续变更，最终导致站点无限重建。

1. 版本更替（最彻底） #

• 升级到Hugo v0.83.0及以上正式版本，官方已在该版本修复了fsutil watcher的空指针问题，无需修改现有配置即可直接解决。
• 若暂时不能升级大版本，可降级到Hugo v0.81.0，该版本未引入存在缺陷的watch逻辑。

2. 临时规避（不更换版本时使用） #

启动hugo server时添加对应参数绕过缺陷逻辑：

• 添加--no-watch参数，手动关闭自动监听功能，需要预览变更时手动重启服务即可。
• 添加--poll 1000参数，用轮询模式替代系统原生文件监听，1000为轮询间隔（单位毫秒），可按需调整，该模式不会触发fsutil相关缺陷，仅会略微提高CPU占用。
• 可以搭配--ignoreCache参数使用，避免缓存异常触发重复构建。

3. 环境排查 #

如果以上方案无法解决，可依次检查以下配置：

• 确认站点目录没有被杀毒软件、网盘同步工具（如OneDrive、百度网盘）同时读写，这类工具修改文件属性会被监听逻辑识别为文件变更，触发重建。
• 检查自定义主题是否存在自动生成临时文件的逻辑，若临时文件存放在站点根目录下，也会触发监听。
• 可以在站点配置文件中添加ignoreFiles配置，指定不需要监听的目录，减少监听文件总数，示例配置：ignoreFiles = ["static/unused/*"]。

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