GitHub Pages怎么用

# GitHub Pages怎么用

GitHub Pages 是 GitHub 提供的静态网站托管服务，可以免费托管个人、项目或组织页面。它支持自动构建（通过 Jekyll）或直接发布静态 HTML 文件，非常适合搭建博客、项目文档或个人主页。以下是详细使用指南：

---

## 一、准备工作
1. **注册 GitHub 账号**  
   访问 [GitHub官网](https://github.com) 注册账号（已有账号可跳过）。
2. **安装 Git**  
   下载 [Git](https://git-scm.com/) 并配置用户名和邮箱：
   ```bash
   git config --global user.name "你的用户名"
   git config --global user.email "你的邮箱"

二、创建仓库

GitHub Pages 依赖特定命名的仓库： - 个人主页：仓库名必须为 用户名.github.io（如 Alice.github.io）。 - 项目页面：可任意命名，需在设置中启用 Pages 功能。

操作步骤： 1. 点击 GitHub 主页右上角的 + → New repository。 2. 输入仓库名（如 username.github.io），选择公开（Public），勾选 Add a README file。 3. 点击 Create repository。

三、上传网站文件

方法1：手动上传

1. 在仓库页面点击 Add file → Upload files。
2. 拖拽或选择本地 HTML/CSS/JS 文件上传。
3. 提交更改（Commit changes）。

方法2：使用 Git 命令行

git clone https://github.com/用户名/用户名.github.io.git
cd 用户名.github.io
echo "Hello World" > index.html  # 创建示例文件
git add .
git commit -m "初次提交"
git push origin main

四、启用 GitHub Pages

1. 进入仓库 → Settings → Pages。
2. 在 Branch 下拉菜单中选择分支（如 main 或 gh-pages）。
3. 点击 Save，稍等几分钟，页面会显示发布链接（如 https://用户名.github.io）。

五、自定义域名（可选）

1. 在域名服务商处添加 CNAME 记录，指向 用户名.github.io。
2. 在仓库根目录创建 CNAME 文件（无后缀），内容为你的域名（如 example.com）。
3. 在 GitHub Pages 设置中填写域名并保存。

六、使用 Jekyll 建博客

GitHub Pages 默认支持 Jekyll 静态网站生成器： 1. 在仓库中添加 _config.yml 文件配置 Jekyll。 2. 创建 _posts 文件夹存放 Markdown 格式的博客文章（文件名格式：YYYY-MM-DD-标题.md）。 3. 推送后会自动构建网站。

示例文章头信息：

---
layout: post
title: "我的第一篇博客"
date: 2023-10-01
---

七、常见问题

1. 页面未更新：强制刷新浏览器或等待缓存失效（最多 10 分钟）。
2. 404 错误：检查仓库名是否正确，或删除 CNAME 文件后重新配置。
3. 自定义域名 HTTPS 报错：在 Pages 设置中重新启用 HTTPS。

通过以上步骤，你可以快速搭建一个免费、稳定的静态网站。如需动态功能，可结合 API 或第三方服务（如 Disqus 评论）扩展。
提示：GitHub Pages 每月流量限制为 100GB，适合中小型项目。
”`

（全文约 700 字）