GitHub Pages页面导航Href链接报404，缺失仓库名问题求助

问题根源 #

你用的是根绝对路径（以/开头，比如/index.html），但GitHub Pages的项目站点需要在路径前附加仓库名称，否则会直接跳转到域名根目录，丢失仓库名导致404。

具体修复方案 #

方案1：给绝对路径加上仓库前缀 #

把所有导航链接的href值前面加上仓库名/GreatestAppEver，示例修改如下：
原代码：

<header>Weight Lifting Guide
    <p class="link">
      <a href="/index.html">Home</a>
    </p>
    <p class="link">
      <a href="/assets/html/nutrition.html">Calculator</a>
    </p>
    <p class="link">
      <a href="/assets/html/progress.html">Progress</a>
    </p>
    <p class="link">
      <a href="/assets/html/recipe.html">Recipes</a>
    </p>
  </header>

修改后：

<header>Weight Lifting Guide
    <p class="link">
      <a href="/GreatestAppEver/index.html">Home</a>
    </p>
    <p class="link">
      <a href="/GreatestAppEver/assets/html/nutrition.html">Calculator</a>
    </p>
    <p class="link">
      <a href="/GreatestAppEver/assets/html/progress.html">Progress</a>
    </p>
    <p class="link">
      <a href="/GreatestAppEver/assets/html/recipe.html">Recipes</a>
    </p>
  </header>

修改后链接会指向正确的目标路径。

方案2：改用相对路径（推荐，适配本地调试） #

去掉路径开头的/，根据当前文件的层级关系编写相对路径：

• 若当前文件在根目录（比如index.html），直接写目标文件的相对位置：

<a href="index.html">Home</a>
<a href="assets/html/nutrition.html">Calculator</a>

• 若当前文件在子目录（比如assets/html/progress.html），要回到根目录的index.html，用../向上跳转层级：

<a href="../../index.html">Home</a>

方案3：全局设置基础路径（适合多页面项目） #

在所有HTML文件的<head>标签里添加<base>标签，统一指定基础路径：

<head>
  <base href="/GreatestAppEver/">
</head>

之后所有相对路径都会自动拼接这个基础前缀，比如<a href="index.html">会自动解析为/GreatestAppEver/index.html。

额外注意事项 #

GitHub Pages严格区分大小写，修复路径后要确保所有文件名、文件夹名的大小写和链接完全一致（比如链接写progress.html，实际文件不能是Progress.html），避免再次触发404。

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