GitHub如何查看index.html文件

GitHub Pages 并不会自动将任意仓库中的 index.html 文件渲染为可访问的网页，必须手动启用并精确配置发布源（如指定分支和目录），否则只会看到 404 错误或原始代码浏览页；个人站点需严格使用 username.github.io 仓库名并置于 main 分支根目录，项目站点则须在 Settings → Pages 中正确设置分支与文件夹路径，同时注意资源相对路径在部署后会以子路径（如 /repo-name/）为基准，本地开发时就应按此结构组织引用，避免样式丢失或资源加载失败——真正生效的是 GitHub 自动生成的 https://username.github.io/repo-name/ 这类地址，而非原始仓库链接，部署后务必等待右上角绿色提示出现、清除缓存并核对 URL 大小写与协议，才能确保页面正确呈现。

GitHub Pages 要求仓库名或路径符合特定格式

直接把 index.html 丢进任意 GitHub 仓库根目录，不会自动变成可访问的网页——GitHub Pages 不会扫描整个仓库去“找” index.html。它只在你明确启用并配置好发布源后，才从指定位置（如 main 分支的 / 或 /docs 目录）读取文件。

常见错误现象：404 Page not found，或者页面打开是 GitHub 的代码浏览界面，而不是渲染后的 HTML。

• 个人/组织账户必须用 username.github.io 这种仓库名（username 替换为你的 GitHub 用户名），且内容放在 main 分支根目录
• 普通项目仓库可以启用 Pages，但默认发布源是 main 分支的 / (root) 或 /docs 目录，选错就找不到 index.html
• 如果仓库是私有的，GitHub Pages 默认不生效（除非你是付费账号）

启用 GitHub Pages 并确认发布源路径

进入仓库 → Settings → 左侧菜单点 Pages → 在 Build and deployment 区域设置：

• Source：选 Deploy from a branch
• Branch：选 main（或 master，取决于你主分支名）
• Folder：选 /(root)（如果你的 index.html 就在仓库根目录）；如果放进了 docs/ 目录，就选 /docs

保存后，GitHub 会自动构建（通常几秒到一分钟）。页面右上角会出现绿色提示条，显示类似 Live at https://username.github.io/repo-name/ —— 这才是你要访问的 URL。

注意：https://github.com/username/repo-name/index.html 是 GitHub 的原始文件预览链接，浏览器会直接下载或显示源码，**不是** GitHub Pages 渲染效果。

本地 index.html 里写的相对路径可能在 Pages 上失效

GitHub Pages 发布后，URL 路径结构变了。比如你用项目仓库方式部署，实际访问地址是 https://username.github.io/repo-name/，那么所有 CSS、JS、图片的相对引用都会以这个路径为基准。

常见错误现象：页面空白、样式丢失、控制台报 Failed to load resource: the server responded with a status of 404 ()。

• 写 没问题（假设 logo.png 和 index.html 同级）
• 但写