如何在Ionos Deploy Now部署的Hugo静态站点设置自定义404页面？

• 创建404页面文件

  • 若使用主题自带模板：在Hugo项目的content目录下新建404.md，内容示例如下：

    ---
    title: "页面未找到"
    layout: "404"
    ---
    
    # 抱歉，页面不存在
    你访问的页面可能已被移除、更名或暂时不可用。
    [返回首页](/ "")
    

    这里的layout: "404"会调用主题内置的404页面样式，保证和站点风格统一。
  • 若主题无内置404模板：在项目的layouts目录下新建404.html，手动编写适配站点风格的HTML结构，示例：

    {{ partial "header.html" . }}
    <div class="page-404">
      <h1>404 - 页面未找到</h1>
      <p>你要访问的路径不存在，请检查网址是否正确。</p>
      <a href="{{ .Site.BaseURL }}">返回首页</a>
    </div>
    {{ partial "footer.html" . }}
    

    这段代码会复用站点的头部和尾部模板，确保404页面风格和全站一致。

• 本地测试效果
  运行命令hugo server启动本地开发服务器，访问http://localhost:1313/404.html，确认自定义页面样式和内容正常显示。

• 部署到IONOS Deploy Now
  将修改后的404.md或404.html文件提交到你的GitHub仓库，IONOS Deploy Now会自动触发重新构建和部署流程，无需额外配置——它会自动识别Hugo生成的404.html文件并启用。

• 验证线上效果
  部署完成后，访问站点内一个不存在的路径（比如你的域名后拼接/invalid-path），确认自定义404页面已替换默认的纯文本样式。

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