使用 GitHub Pages 部署静态网站完整指南

GitHub Pages 是 GitHub 提供的免费静态网站托管服务，非常适合部署个人博客、项目文档或作品集。本指南将从零开始，带你完成完整的部署流程。

什么是 GitHub Pages？

GitHub Pages 允许你直接从 GitHub 仓库托管静态网站，无需服务器、无需数据库、无需付费。每个 GitHub 账户可以拥有一个用户站点和无限个项目站点。

用户站点访问地址：https://<username>.github.io

第一步：创建仓库

对于用户站点，仓库必须命名为 <username>.github.io。例如，我的用户名是 CyberX0725，所以仓库名为 CyberX0725.github.io。

1. 登录 GitHub，点击右上角 + → New repository
2. 仓库名填入 CyberX0725.github.io
3. 选择 Public（公开）
4. 点击 Create repository

第二步：初始化本地项目

将远程仓库克隆到本地，然后添加你的网站文件：

# 克隆仓库
git clone https://github.com/CyberX0725/CyberX0725.github.io.git

# 进入目录
cd CyberX0725.github.io

# 创建项目结构
mkdir -p assets/css assets/js posts

第三步：推送到 GitHub

将文件添加到 Git 并推送到远程仓库：

# 添加所有文件
git add .

# 提交更改
git commit -m "Initial blog setup"

# 推送到 GitHub
git push origin main

第四步：启用 GitHub Pages

对于用户站点，推送代码后 GitHub Pages 会自动启用。等待 1-2 分钟，你的网站就会在 https://cyberx0725.github.io 上线。

进阶：配置自定义域名

如果你有自己的域名，可以配置为 GitHub Pages 的自定义域名：

1. 在仓库根目录创建 CNAME 文件
2. 文件内容只写你的域名
3. 在域名 DNS 设置中添加 CNAME 记录

# CNAME 文件内容
blog.cyberx0725.com

常见问题

网站显示 404？

• 确认仓库名正确：<username>.github.io
• 确认仓库是 Public
• 确认 index.html 在仓库根目录

资源加载失败？

检查文件路径，确保使用正确的相对路径或绝对路径。

总结

GitHub Pages 是部署静态网站的绝佳选择——免费、简单、与 Git 工作流无缝集成。无论是个人博客、项目文档还是在线简历，都可以在几分钟内上线。

最好的部署方式是最简单的方式。不要为了部署而部署，把精力放在内容上。