Skip to content

FIX_404.md

Latest commit

 

History

History
159 lines (104 loc) · 2.81 KB

FIX_404.md

File metadata and controls

159 lines (104 loc) · 2.81 KB

解决GitHub Pages 404错误

问题

网站显示 404 - There isn't a GitHub Pages site here

原因

GitHub Pages还没有启用。虽然代码已经推送到仓库，但需要在Settings中启用Pages功能。

解决方案

方式1: 手动启用 (最简单)

  1. 打开仓库设置页面

    https://github.com/BobWang21/learning/settings/pages

  2. 找到 "Build and deployment" 部分

  3. 配置发布源

    • Source: 选择 "Deploy from a branch"
    • Branch: 选择 "main"
    • Folder: 选择 "/ (root)"

  4. 点击 Save 按钮

  5. 等待 1-3 分钟

  6. 刷新网站

    https://bobwang21.github.io/learning/

方式2: 使用脚本启用

如果你有GitHub token，可以使用自动化脚本：

# 获取token: https://github.com/settings/tokens
# 选择 "repo" 权限

cd /Users/wangbao/ts-model-survey
bash enable_pages.sh your_token_here

或者：

export GITHUB_TOKEN=your_token_here
bash enable_pages.sh

步骤详解

第1步: 访问设置页面

打开浏览器，访问：

https://github.com/BobWang21/learning/settings/pages

第2步: 找到Pages设置

页面会显示 "Build and deployment" 部分

第3步: 选择发布源

在 "Source" 下拉菜单中：

  • 如果显示 "None"，点击选择 "Deploy from a branch"
  • 如果已经选中，确保选择的是 "Deploy from a branch"

第4步: 选择分支

在 "Branch" 下拉菜单中：

  • 第一个下拉框：选择 "main"
  • 第二个下拉框：选择 "/ (root)"

第5步: 保存

点击 "Save" 按钮

第6步: 等待构建

GitHub会自动构建和部署网站，通常需要 1-3 分钟

第7步: 验证

等待后访问：

https://bobwang21.github.io/learning/

预期结果

网站应该显示：

  • ✓ 紫色渐变侧边栏
  • ✓ "时序模型调研" 标题
  • ✓ 导航菜单
  • ✓ 完整的内容

常见问题

Q: 还是显示404?

A:

  1. 确保已点击 Save
  2. 等待 2-3 分钟
  3. 清除浏览器缓存 (Ctrl+Shift+Delete)
  4. 刷新页面 (Ctrl+F5)
  5. 检查Settings中是否显示 "Your site is live at..."

Q: 网站显示但样式不对?

A:

  1. 刷新页面 (Ctrl+F5)
  2. 清除浏览器缓存
  3. 检查styles.css是否正确上传

Q: 如何验证文件是否上传?

A: 访问：

https://github.com/BobWang21/learning/blob/main/index.html

应该能看到HTML代码

快速链接

完成!

按照上述步骤操作后，你的网站就会上线！

如有问题，请检查：

  1. Pages是否启用
  2. 分支是否是main
  3. 文件夹是否是/ (root)
  4. 是否已点击Save