浏览文档

疑难解答

2024年3月7日 1 分钟阅读 文档 问题排查

列出一些已知问题和相应的解决方案，以帮助你排查问题。

赞助

成为我们的资助者或赞助商，以支持我们的工作。

爱发电 GitHub 赞助商 PayPal
本页内容
赞助商

缺少配置文件

当你忘了挂载站点到默认工作目录，又或者挂载到错误的目录，则会遇到一下问题。

1Error: Unable to locate config file or config directory. Perhaps you need to create a new site.
2Run `hugo help new` for details.

未知的命令或模块

当执行一个不存在的命令时，可能会出现下面类似的错误。

一些从 klakegg/hugo 迁移过来的用户可能遇到这个问题，因为 hugomods/hugo 并不会为 Hugo 命令添加额外的快捷方式，比如 server 对应 hugo server，也就是说，镜像并不存在这样的 server 命令，你只需要将其替换为原本的命令即可，比如将 server 替换为 hugo server。

1docker: Error response from daemon: failed to create task for container: failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: exec: "*": executable file not found in $PATH: unknown.

 1node:internal/modules/cjs/loader:1051
 2  throw err;
 3  ^
 4
 5Error: Cannot find module '/src/server'
 6    at Module._resolveFilename (node:internal/modules/cjs/loader:1048:15)
 7    at Module._load (node:internal/modules/cjs/loader:901:27)
 8    at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:83:12)
 9    at node:internal/main/run_main_module:23:47 {
10  code: 'MODULE_NOT_FOUND',
11  requireStack: []
12}
13
14Node.js v20.7.0

Hugo 服务器并未运行或者进程已退出

Hugo 构建站点后，会显示一些统计信息，当你发现进程退出而没有任何错误，该进程很可能被系统终止了。

其中一个常见的原因是内存不足，为了修复内存问题，你可以选择：

  1. 添加更多内存。
  2. 对于 Hugo 0.123.0 或后续的版本，若启用了 --renderToMemory 参数，则禁用之。
  3. 对于 Hugo 0.122.* 或更早的版本，则使用 --renderToDisk 参数。
贡献