我推荐的、也是目前最主流的组合是:Hexo + GitHub Pages

  • Hexo:一个基于 Node.js 的静态博客框架。它非常受中文社区欢迎,主题(皮肤)超级多,文档也全,你写 Markdown 非常方便。
  • GitHub Pages:GitHub 提供的免费静态网页托管服务。

详细步骤:从零开始搭建 Hexo + GitHub Pages 博客

你只需要跟着这几步走,就能搭建完成。

第 1 步:准备工作(安装必备软件)

在开始之前,你的电脑上需要有 GitNode.js

  1. 安装 Git

    • 访问 Git 官网 下载并安装。

    • 安装后,打开你的终端(Windows 叫 “CMD” 或 “PowerShell”,Mac/Linux 叫 “Terminal”),输入 git --version,能看到版本号就说明装好了。

  2. 安装 Node.js

    • 访问 Node.js 官网,下载 “LTS” (长期支持) 版本并安装。

    • 安装后,在终端输入 node -vnpm -v,能看到版本号就说明装好了。

第 2 步:在 GitHub 上创建仓库

这是你未来存放网站的地方。

  1. 登录你的 GitHub 账号。

  2. 创建一个新的公开的 (Public) 仓库。

  3. 关键一步:仓库的名称必须你的GitHub用户名.github.io

    • 例如,如果你的用户名是 zhangsan,那么仓库名就是 zhangsan.github.io

第 3 步:在本地安装和初始化 Hexo

  1. 全局安装 Hexo:

    打开终端,运行以下命令:

    1
    npm install -g hexo-cli
  2. 初始化博客文件夹:

    在你电脑上找一个喜欢的位置(比如 D 盘或“文稿”目录),然后在终端里 cd 过去。运行:

    1
    hexo init my-blog  # "my-blog" 是你博客的文件夹名,可以自定义
  3. 进入并安装依赖

    1
    2
    cd my-blog
    npm install

    现在,你的博客框架已经在 my-blog 文件夹里了。

第 4 步:本地预览(看你博客的样子)

Hexo 有一个本地服务器,可以让你在发布前先在自己电脑上预览。

  1. 在终端(必须在 my-blog 目录内)运行:

    1
    hexo server

    或者简写 hexo s

  2. 打开浏览器,访问 http://localhost:4000

  3. 你会看到一个默认主题的 Hexo 博客。按 Ctrl + C 可以关闭本地服务器。

第 5 步:写你的第一篇 Markdown 博客

  1. 在终端(仍在 my-blog 目录)运行:

    1
    hexo new "Hello World"
  2. Hexo 会在 my-blog/source/_posts/ 目录下创建一个 Hello-World.md 文件。

  3. 你用任何 Markdown 编辑器(比如 VS Code, Typora)打开这个 .md 文件,就可以开始写作了。

第 6 步:配置部署(让 Hexo 知道你的 GitHub 仓库)

  1. 安装 Git 部署插件:

    在 my-blog 目录的终端中运行:

    1
    npm install hexo-deployer-git --save
  2. 修改配置文件:

    打开 my-blog 文件夹根目录下的 _config.yml 文件(注意是根目录的,不是主题里的)。

  3. 滚到文件最底部,找到 deploy: 部分,修改成这样(注意冒号后面必须有空格):

    1
    2
    3
    4
    deploy:
    type: git
    repo: https://github.com/你的用户名/你的用户名.github.io.git
    branch: main # 或者 master,取决于你 GitHub 仓库的默认分支是啥
    • 你的用户名 替换成你自己的 GitHub 用户名。

第 7 步:一键生成和部署(发布网站)

这是最后一步。

  1. 生成静态文件:Hexo 会把你的 Markdown 文件转换成 HTML。

    1
    hexo generate

    (或者简写 hexo g

  2. 部署到 GitHub

    1
    hexo deploy

    (或者简写 hexo d

    这个命令会做两件事:

    • 自动执行 hexo g 来生成最新的静态文件。

    • 把生成的网站内容(public 目录下的所有东西)推送到你第 2 步创建的 your-username.github.io 仓库里。

    (注:第一次部署时,Git 可能会提示你输入 GitHub 的用户名和密码/Token。)

第 8 步:访问你的公网博客

部署成功后,等待 1-2 分钟(GitHub Pages 需要一点时间反应)。

在浏览器中访问: https://angelysss.github.io

恭喜!你现在有了一个完全免费、支持 Markdown、并且公网可访问的个人博客了。


后续维护

  • 写新文章:重复第 5 步(hexo new "文章名")和第 7 步(hexo d)。
  • 换主题:如果你不喜欢默认主题,可以去 Hexo 主题官网 挑选。更换主题通常只需要下载主题文件,并在 _config.yml 里改一个 theme: 字段的值,非常简单。
  • 数据安全:你的所有博文(.md 文件)都在本地的 my-blog/source/_posts 文件夹里,请一定做好备份(比如单独用一个 Git 仓库来存这些源文件)。