这文章现在的作用是可以一步到位不用追问 AI ,避免碎片化操作带来问题。

Tip

这里只提供思路,并不做详细教程(AI 会告诉你怎么做)。

🚀 环境准备

在开始之前,您需要先在电脑上安装 Node.js 和 Git 。

  1. 安装 Node.js: 访问 Node.js 官网 下载并安装适合您操作系统的版本 (推荐 LTS 版本)。

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

📝 安装 Hexo 并初始化博客

无脑逐步执行下面的命令即可。

# 1. 全局安装Hexo命令行工具
npm install hexo-cli -g

# 2. 初始化博客项目(blog是文件夹名称,可自定义)
hexo init blog

# 3. 进入博客目录
cd blog

# 4. 安装必要的依赖包
npm install

# 5. 启动本地服务器(默认端口4000)
hexo server

完成 hexo server 后,如果终端显示 INFO Hexo is running at http://localhost:4000/ ,说明你的本地博客已成功启动。接下来你可以在浏览器中输入这个地址来预览博客。

🏷 认识目录结构

.
├── _config.yml         # 核心配置文件,掌管网站的一切
├── package.json        # 项目依赖信息
├── scaffolds/          # 文章模板文件夹
|   ├── draft.md        # 草稿模板
|   ├── page.md         # 页面模板
|   └── post.md         # 文章模板
├── source/             # 您的所有源文件都在这里
|   └── _posts/         # 存放所有 .md 博客文章的地方
└── themes/             # 存放所有主题的文件夹

💡 后续操作

成功在本地运行博客后,通常会进行以下操作:

  • 编写新文章:官方教程显示使用命令 hexo new "我的第一篇文章" ,Markdown文件会自动创建在 source/_posts 目录下,编辑后保存即可,这样很不方便,实际你可以直接在你的笔记软件打开 _posts文件夹,进行添加编写文章,并且可新建文件夹对文章进行管理分类。

  • 更换主题:可以在Hexo官方主题网站或GitHub上寻找喜欢的主题,下载到 themes 目录,按照主题的配置说明,修改博客根目录下的 _config.yml 配置文件中的 theme 字段来启用新主题。

  • 部署到线上:当你准备好将博客公之于众时,可以将其部署到GitHub Pages或Gitee Pages等免费托管服务上。

🎨 Hexo 主题安装与配置攻略

可以从以下地方寻找喜欢的主题:

假设我们看中了 NexT 主题。

  1. 进入 themes 文件夹: 首先,确保您的终端位于博客根目录 ( my-blog ) 下。

  2. 克隆主题仓库: 使用 git clone 命令将 NexT 主题下载到 themes/next 文件夹内。

git clone https://github.com/next-theme/hexo-theme-next themes/next
  1. 修改站点配置文件: 打开您博客根目录下的 _config.yml 文件 (注意不是主题文件夹里的那个)。找到 theme 字段,并将其值修改为您刚刚下载的主题文件夹名称。
# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: next  # 将 landscape 修改为 next
  1. 清理并重新生成: 为了确保旧的主题文件被清除,新主题能正确应用,请运行以下命令:
hexo clean  # 清除缓存文件 (db.json) 和已生成的静态文件 (public)
hexo generate # 重新生成静态文件
  1. 再次预览: 刷新 http://localhost:4000 ,应该能看到网站已经成功换上了 NexT 主题!
hexo server

个性化主题

每个主题都有自己独立的配置文件,用于进行更细致的个性化设置。

  • 主题配置文件: 这个文件位于 themes/next/_config.yml 。

  • 常见配置: 您可以在这里修改菜单、侧边栏、社交链接、头像、打赏功能、网站分析等等。

建议仔细阅读您所使用主题的官方文档,那里面会有最详细的配置说明。

接下来就是不断创作内容,以及根据您的喜好去探索和配置主题了。

🎉 部署上线,通过网址访问

这里目前只有部署到GitHub pages上的经验,所以以这个为例:

  1. 注册一个GitHub账号。
  2. 创建一个仓库,配置好仓库。
  3. 把项目推送到远程仓库。

光是部署到GitHub pages上访问显然不行,所以可以用下面的服务商进行静态托管:

  1. 这里可以用cloudflare,腾讯edge 的pages,阿里云的pages。
  2. 需要自己的域名可以购买一个,这里推荐阿里云或cloudflare进行域名。
  3. 阿里云域名可以迁移到Cloudflare DNS管理,这样做的好处就是不用备案。
  4. 打开域名控制台,点击购买的域名“管理”:

点击管理

  1. 修改 DNS 服务器
image-20251210215111190