如何在GitHub Pages中创建不带.html后缀的路径页面?
解决GitHub Pages无.html后缀路径的问题
检查基础配置与部署细节
文件夹+index.html的方法本身是GitHub Pages支持的,没生效大概率是细节没做对:- 文件夹名称必须和目标路径完全一致:要实现
website.com/overflow,就得建名为overflow的文件夹,里面放index.html,别用folder这种不对的名字。 - 注意文件名和文件夹名的大小写:GitHub Pages对大小写敏感,
Overflow和overflow会被识别成两个不同路径。 - 部署后等几分钟再测试:GitHub Pages部署有延迟,不是修改完立刻生效,刷新浏览器缓存再试。
- 文件夹名称必须和目标路径完全一致:要实现
用Jekyll配置永久链接(默认启用Jekyll的情况)
GitHub Pages默认用Jekyll构建页面,通过配置permalink可以统一或单独设置无后缀路径:- 仓库根目录新建或修改
_config.yml,加一行:permalink: /:title/,这样所有页面都会自动生成无.html后缀的路径。 - 要是只想给单个页面设置,就在该页面的开头加YAML配置:
保存后重新部署,这个页面就对应--- permalink: /overflow/ ---website.com/overflow路径。
- 仓库根目录新建或修改
应急方案:重定向跳转
要是上面的方法都没效果,可以用重定向兜底:- 先创建
overflow.html页面,在<head>里加这段JS代码:<script> window.location.pathname = '/overflow'; </script> - 同时保留
overflow文件夹和里面的index.html,这样用户不管访问带.html的路径还是不带的,都能打开目标页面。
- 先创建
内容的提问来源于stack exchange,提问作者CreeperGamerUsesStackNow
相关产品推荐
相关产品推荐

