hexo搭建博客步骤

By | 2025-05-05

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

前期准备

  1. 注册GitHub账号：如果还没有GitHub账号，先在GitHub官网进行注册。
  2. 安装Git：从Git官网下载适合你操作系统的版本进行安装。安装完成后，打开命令行工具（如Git Bash），输入git config --global user.name "yourname"和git config --global user.email "youremail"，分别将yourname和youremail替换为你的GitHub用户名和邮箱，用于验证身份。
  3. 安装Node.js和npm：从Node.js官网下载并安装Node.js，npm会随Node.js一起安装。安装完成后，在命令行中输入node -v和npm -v，查看是否输出版本号，以确认是否安装成功。

搭建博客

  1. 创建GitHub仓库：登录GitHub，点击“New repository”按钮创建一个新仓库。仓库名称必须为yourusername.github.io，其中yourusername是你的GitHub用户名，否则会出现页面404的情况。
  2. 全局安装Hexo：打开命令行工具，输入npm i hexo-cli -g命令全局安装Hexo。安装完成后，输入hexo -v查看版本号，确认Hexo是否安装成功。
  3. 初始化Hexo项目：在你希望存放博客项目的目录下，右键选择“Git Bash Here”（如果是Windows系统）或打开终端（如果是Mac或Linux系统），输入hexo init yourblogname，yourblogname是你为博客项目取的名称，之后会在该目录下生成Hexo项目所需的文件。
  4. 进入项目文件夹并安装依赖：输入cd yourblogname进入项目文件夹，然后执行npm install命令安装项目所需的依赖文件。
  5. 运行博客：输入hexo s（s是start的简写）启动博客服务，然后在浏览器中访问http://localhost:4000，即可看到默认的Hexo博客页面。

更换主题

  1. 选择主题：访问Hexo主题官网挑选喜欢的主题。例如，若选择Anisina主题，可访问主题GitHub地址查看安装教程。
  2. 安装主题：在项目目录下的命令行中输入git clone https://github.com/Haojen/hexo-theme-Anisina.git themes/Anisina，将主题克隆到themes文件夹下。主题不同，安装命令可能有所差异，需根据具体主题的说明进行操作。
  3. 修改配置文件：打开项目根目录下的_config.yml文件，找到theme字段，将其值改为你安装的主题名称，如Anisina。
  4. 重启博客：执行hexo clean清除缓存，再执行hexo s重新启动博客，即可看到更换后的主题效果。

部署到GitHub

  1. 配置部署信息：打开项目根目录下的_config.yml文件，找到deploy字段，修改为如下内容，将yourusername替换为你的GitHub用户名：
    deploy:
  type: git
  repo: https://github.com/yourusername/yourusername.github.io.git
  branch: main
  2. 安装部署插件：在项目目录下的命令行中输入npm install hexo-deployer-git --save安装部署插件。
  3. 执行部署命令：依次执行以下命令，将本地项目部署到GitHub上。执行hexo clean清除之前生成的文件（可选），hexo generate（可简写为hexo g）生成静态文件，hexo deploy（可简写为hexo d）将文件推送到GitHub仓库。部署过程中可能需要输入GitHub用户名和密码进行验证。

撰写文章

  1. 新建文章：在项目目录下的命令行中输入hexo new "article title"，article title是你文章的标题，执行命令后会在source/_posts目录下生成一个对应的Markdown文件，以及一个与文章同名的文件夹（前提是在_config.yml文件中配置了post_asset_folder: true），用于存放文章相关的资源，如图片等。
  2. 撰写内容：使用文本编辑器打开生成的Markdown文件，按照Markdown语法撰写文章内容。
  3. 生成并查看文章：写完文章后，执行hexo g生成静态文件，再执行hexo s启动博客服务，在浏览器中访问http://localhost:4000，即可查看新撰写的文章。如果文章有更新，只需再次执行hexo g和hexo s命令，刷新浏览器即可看到更新后的内容。
  4. 部署文章：文章撰写完成并确认无误后，执行hexo d命令，将文章部署到GitHub上，使其他人能够通过你的博客网址访问到新文章。