Hexo博客日常更新指南与备忘录

发表于 更新于 分类于 ，

🚀 Hexo 博客更新标准化流程

随着博客全面转向计算机基础 (408) 和考研数学一的记录，后续会有大量带有代码块和复杂公式的笔记产出。为了避免每次更新都要靠记忆去回忆命令行，特在此沉淀一份标准的 Hexo 博客更新流程，作为自己的“第二大脑”备忘录。

🛠️ 第一步：新建文章 (Create)

不要手动新建 .md 文件！手动新建会导致时间戳缺失或格式错误。

  1. 打开 VS Code，调出终端（确保是 PowerShell 环境），进入博客根目录 D:\myblog。
  2. 运行新建命令：
    hexo new "你的文章标题"
  3. 执行后，Hexo 会自动在 source/_posts/ 目录下生成一个同名的 Markdown 文件，并且自动填充好当前的精准时间。

📝 第二步：完善文章头部信息 (Front-matter)

打开刚刚生成的文件，最上方的 --- 包围区域是文章的元数据。需要在此处配置好分类（Categories）和标签（Tags），以便自动归档到左侧边栏。

标准格式参考：
categories: 下方使用 - [主分类, 子分类] 的格式配置多级分类。
tags: 下方使用 - 标签名 的格式配置多个标签。

🔍 第三步：本地预览 (Preview)

在把文章推送到外网之前，先在本地看看排版效果（特别是 C++ 代码高亮和 LaTeX 数学公式是否正常渲染）。

在终端输入：
hexo server

运行后，在浏览器中打开 http://localhost:4000 即可实时预览。修改 Markdown 文件并保存后，网页会自动刷新。确认无误后，在终端按 Ctrl + C 退出预览模式。

🚀 第四步：一键生成与部署 (Deploy)

由于使用的是 Windows PowerShell，不支持传统的 && 连接符，统一使用分号 ; 来串联命令。

专属一键部署指令：
hexo clean; hexo g -d

指令拆解说明：

  • hexo clean：清除本地缓存。
  • hexo g -d：生成静态网页文件并立即自动部署到 GitHub。

💡 常见踩坑记录

  1. 首页 README.md 丢失问题：
    如果配置了 GitHub 仓库的主页介绍（README.md），一定要把该文件放在本地博客的 source 文件夹下，并在 _config.yml 中设置 skip_render: README.md。否则每次 hexo d 都会把它覆盖或转化成网页。
  2. 时间戳报错：
    如果手动创建了文件，记得把头部的 date 修改为具体的标准时间（如 2026-02-15 12:00:00），否则 Hexo 编译会报错。

保持输出，拒绝机械抄书。Focus on 408 & Math! 🏃