You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何将GitHub Pages页面URL修改为无.html后缀的简洁短路径

GitHub Pages 实现干净路径访问配置方案

GitHub Pages 原生支持无后缀路径访问,不需要配置服务端重写规则,按以下步骤调整即可:

1. 调整目录结构

将存放在assets目录下的两个页面文件,移动到根目录下对应名称的子文件夹中,并重命名为index.html,静态资源文件保留在原assets目录即可。调整后的文件结构如下:

.
├── index.html          # 对应首页路径 domain.com/
├── about/
│   └── index.html      # 原assets/about.html迁移至此,对应路径 domain.com/about
├── design/
│   └── index.html      # 原assets/design.html迁移至此,对应路径 domain.com/design
└── assets/
    └── styles.css      # 样式等静态资源保持原存放路径

GitHub Pages 收到/xxx格式的路径请求时,会自动匹配对应xxx目录下的index.html文件返回,访问时地址栏不会显示index.html后缀,完全符合你需要的URL格式。

2. 修正页面内链接与资源引用

页面位置调整后,需要统一修改导航链接和静态资源引用路径,避免出现404错误:

  • 导航链接全部改为基于根目录的相对路径,替换原有href属性:
<a class="nav-item" href="/about">About</a>
<a class="nav-item" href="/">Home</a>
<a class="nav-item" href="/design">Design</a>
  • 所有页面对styles.css的引用路径,统一修改为/assets/styles.css,不要使用./开头的相对路径,避免子页面加载资源时路径匹配错误。

3. 自定义域名兼容说明

你绑定的GoDaddy自定义域名不需要做任何额外解析配置,上述文件调整完成后推送到GitHub仓库,等待Pages部署完成即可直接通过domain.com/about、domain.com/design访问对应页面。

如果需要兼容之前的旧路径/assets/about.html、/assets/design.html,避免旧链接失效,可以在原assets目录下保留两个html文件,写入简单的跳转规则即可,以about页面为例:

<!-- assets/about.html -->
<!DOCTYPE html>
<html>
<head>
  <meta http-equiv="refresh" content="0; url=/about">
</head>
</html>

design页面对应修改跳转目标为/design即可,访问旧路径时会自动跳转到新的干净URL。

内容的提问来源于stack exchange,提问作者956MB

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.29 23:54:18