如何创建GitHub个人网站本文将详细介绍如何从零开始搭建一个基于GitHub Pages的个人网站，包括环境配置、仓库创建、Hexo框架安装以及主题配置等全过程。
准备工作在开始之前，请确保你的电脑已经安装以下工具：
Node.js (建议选择LTS版本)
Git
1. 配置SSH密钥
生成SSH密钥：
1ssh-keygen -t rsa -C "你的邮箱地址"
查看公钥内容：
1cat ~/.ssh/id_rsa.pub # Windows系统使用: type C:\Users\用户名\.ssh\id_rsa.pub
复制公钥内容，前往GitHub设置页面：
访问 GitHub SSH设置
点击 “New SSH key”
填写标题（如：My PC）
粘贴公钥内容
点击 “Add SSH key”
测试SSH连接：
1ssh -T git@github.com
2. 创建GitHub Pages仓库
登录GitHub，点击右上角 “+” 号，选择 “New repository”
仓库名称必须为：你的用户名.github.io
选择 “Public”
点击 “Create repository”
3. 安装Hexo框架
全局安装Hexo-CLI：
1npm install -g hexo-cli
创建博客项目：
123hexo init blogcd blognpm install
安装必要插件：
12npm install hexo-deployer-git --savenpm install hexo-renderer-pug hexo-renderer-stylus --save
4. 配置Hexo
编辑根目录下的 _config.yml，修改以下配置：
1234567891011121314151617# Sitetitle: 你的网站标题subtitle: 副标题description: 网站描述keywords: 关键词author: 作者名language: zh-CNtimezone: Asia/Shanghai# URLurl: https://你的用户名.github.io# Deploymentdeploy: type: git repo: git@github.com:你的用户名/你的用户名.github.io.git branch: main
5. 安装Butterfly主题
下载主题：
1git clone https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
修改Hexo配置文件 _config.yml：
1theme: butterfly
创建主题配置文件：
123# 在博客根目录创建文件：_config.butterfly.yml# 从主题目录复制配置cp themes/butterfly/_config.yml _config.butterfly.yml
6. 创建GitHub Actions自动部署
在博客根目录创建 .github/workflows/deploy.yml：
12345678910111213141516171819202122name: Deployon: push: branches: - mainjobs: deploy: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 - uses: actions/setup-node@v2 with: node-version: '16' - run: npm install - run: npm run build - name: Deploy uses: peaceiris/actions-gh-pages@v3 with: github_token: ${{ secrets.GITHUB_TOKEN }} publish_dir: ./public
7. 本地预览与部署
本地预览：
12hexo clean # 清除缓存hexo server # 启动本地服务器
访问 http://localhost:4000 预览效果
部署到GitHub：
12hexo clean # 清除缓存hexo deploy # 部署到GitHub
8. 自定义域名（可选）
在你的域名服务商处添加DNS记录：
类型：CNAME
主机记录：www 或 @
记录值：你的用户名.github.io
在博客的source目录下创建CNAME文件：
1echo "你的域名" > source/CNAME
常见问题解决
部署失败：
检查SSH配置是否正确
确认仓库名称格式是否正确
验证GitHub Actions配置文件语法
主题显示异常：
检查主题依赖是否安装完整
确认配置文件格式是否正确
清除缓存后重新生成
结语至此，你的GitHub个人网站就搭建完成了。你可以通过 https://你的用户名.github.io 访问你的网站。接下来，你可以：
开始写作你的第一篇博客
自定义主题样式
添加更多功能插件
优化网站性能
记得经常备份你的博客源文件，建议创建一个单独的仓库来存储。
祝你使用愉快！