瀏覽文檔

疑難解答

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 參數。
貢獻