hexo搭建

以下是使用 GitHub Pages 搭建 Hexo 博客的详细步骤：

1. 准备工作

  1. 安装 Node.js
    访问 Node.js 官网 下载并安装最新 LTS 版本。

  2. 安装 Git
    访问 Git 官网 下载并安装 Git。

  3. 注册 GitHub 账号
    如果没有账号，请先注册 GitHub。

2. 安装 Hexo

  1. 打开终端（或命令行工具），执行以下命令安装 Hexo CLI：

    1
    npm install -g hexo-cli

  2. 初始化 Hexo 项目：

    1
    2
    3
    hexo init my-blog  # 创建名为 "my-blog" 的文件夹
    cd my-blog         # 进入项目目录
    npm install         # 安装依赖

3. 本地预览博客

  1. 生成静态文件并启动本地服务器：

    1
    2
    hexo generate  # 或简写 hexo g
    hexo server    # 或简写 hexo s

  2. 浏览器访问 http://localhost:4000，即可预览博客。

4. 配置 GitHub Pages

  1. 创建 GitHub 仓库
    登录 GitHub，新建一个仓库，仓库名必须为 <你的用户名>.github.io（例如 john.github.io）。

  2. 配置 Hexo 部署设置
    在 Hexo 项目根目录中，编辑 _config.yml 文件，找到 deploy 部分，修改为：

    1
    2
    3
    4
    deploy:
      type: git
      repo: https://github.com/你的用户名/你的用户名.github.io.git  # 替换为你的仓库地址
      branch: main  # GitHub 默认分支为 main

  3. 安装部署插件
    在终端中执行：

    1
    npm install hexo-deployer-git --save

5. 部署到 GitHub Pages

  1. 生成静态文件并部署：

    1
    2
    3
    hexo clean     # 清除缓存
    hexo generate  # 生成静态文件
    hexo deploy    # 或简写 hexo d

  2. 访问 https://你的用户名.github.io，即可看到你的博客。

6. 更新博客内容

  1. 新建文章 

    1
    hexo new "文章标题"

    文章 Markdown 文件会生成在 source/_posts 目录下，编辑后重新部署即可。

  2. 更换主题

    • 在 Hexo 主题库 选择主题，按主题文档安装。
    • 修改 _config.yml 中的 theme 字段为所选主题名。

常见问题

  1. 页面无法加载（404）

    • 确认仓库名是否为 <用户名>.github.io。
    • 检查 GitHub Pages 设置：仓库 → Settings → Pages → 分支是否设为 main/master。

  2. 部署后无变化

    • 执行 hexo clean 清除缓存再重新部署。

  3. 自定义域名

    • 在博客根目录的 source 文件夹下新建 CNAME 文件，写入你的域名（如 example.com）。
    • 在域名服务商处添加 DNS 解析到 GitHub Pages。

按照以上步骤操作，即可快速搭建并部署 Hexo 博客到 GitHub Pages。遇到问题可参考 Hexo 文档 或 GitHub 社区讨论。