技术分享
🗒️hexo安装部署教程
00 分钟
2025-10-7
2025-10-7
type
status
date
slug
summary
tags
category
password
icon
以下是 Hexo 的安装与部署详细教程，适用于初次使用 Hexo 搭建静态博客的教程：

一、环境准备

Hexo 基于 Node.js 和 Git，需先安装这两个工具：
  1. 安装 Node.js
      • 验证安装：终端输入 node -v 和 npm -v，显示版本号即成功
  1. 安装 Git
      • 验证安装：终端输入 git --version，显示版本号即成功

二、安装 Hexo

  1. 全局安装 Hexo 脚手架
      2. 打开终端，执行以下命令：
      验证安装：hexo -v 显示版本信息即成功。
  1. 初始化博客项目

    三、本地预览博客

    1. 生成静态文件
      1. 启动本地服务器
          2. 访问 http://localhost:4000 即可看到默认博客页面。

      四、创建第一篇文章

      1. 新建文章
          2. 文章会生成在 source/_posts/ 目录下，格式为 Markdown。
      1. 编辑文章
          2. 用 Markdown 编辑器打开文件，写完后保存。
      1. 重新预览
          2. 按 Ctrl+C 停止本地服务器，重新执行 hexo g && hexo s 即可看到更新。

      五、部署到 GitHub Pages

      1. 准备工作

      • 注册 GitHub 账号，创建一个仓库，仓库名必须为：用户名.github.io（如 xxx.github.io）

      2. 安装部署插件

      在博客目录下执行：

      3. 配置部署信息

      编辑博客目录下的 _config.yml 文件，在末尾添加：

      4. 部署到 GitHub

      首次部署需输入 GitHub 账号密码或 Token 验证。

      5. 访问博客

      部署成功后，访问 https://用户名.github.io 即可看到你的博客。

      六、常用命令总结

      命令
      简写
      说明
      hexo new "标题"
      hexo n "标题"
      创建新文章
      hexo generate
      hexo g
      生成静态文件
      hexo server
      hexo s
      启动本地服务器
      hexo deploy
      hexo d
      部署到远程仓库
      hexo clean
      -
      清除缓存和生成的文件

      七、进阶操作

      1. 更换主题：在 Hexo 主题官网 挑选主题，下载后放到 themes/ 目录，修改 _config.yml 中的 theme 配置即可。
      1. 配置个性化：修改 _config.yml 文件自定义博客名称、作者、链接等信息。
      1. 绑定域名：在 GitHub 仓库设置中添加自定义域名，并在博客 source/ 目录添加 CNAME 文件（内容为域名）。
      按照以上步骤，你可以快速搭建并部署自己的 Hexo 博客。如果遇到问题，可参考 Hexo 官方文档 或 GitHub 相关教程。
      致谢：
      💡
      有关Notion安装或者使用上的问题，欢迎您在底部评论区留言，一起交流~
       
       
      上一篇
      Notion简明示例用法
      下一篇
      开源静态文档网站生成工具 teedoc
      评论
      Loading...