1. 第一步:安装必备环境
1.1 安装 Node.js(Hexo 运行依赖)
1.1.1 Node.js 下载地址
下载地址:Node.js — 在任何地方运行 JavaScript
点击'下载'。

基于 Hexo 静态博客框架结合 GitHub Pages 免费托管搭建个人博客的全流程。内容包括 Node.js 与 Git 环境安装配置、Hexo 初始化与本地预览、基础配置文件修改、SSH 密钥生成与绑定、以及首次部署上线操作。通过分步指南帮助开发者从零开始完成博客搭建。
下载地址:Node.js — 在任何地方运行 JavaScript
点击'下载'。

滑到页面最下方,点击左下角的蓝色按钮。

再次滑到页面最下方,根据自己电脑配置选择对应的安装包。如果不知道该选什么,可参考下文安装包选择指南。

| 你的电脑情况 | 推荐安装包 | 优点 |
|---|---|---|
| Linux/Unix 系统用户主流 x86_64 架构服务器 / 桌面(Ubuntu、CentOS、Debian 等) | Linux 64-bit Binary (.tar.xz) | 兼容性最广,个人开发者最常用 |
| ARM64 架构设备(如树莓派 4、ARM 云服务器) | ARMv8 64-bit Binary (.tar.xz) | 针对 ARM 架构优化 |
| 企业级服务器(PPC、s390x、AIX 等) | 对应架构的 .tar.xz 包 | 适配专业服务器硬件 |
✅ 快速判断你的 Linux 架构:打开终端输入:
uname -m
输出 x86_64 就是普通 64 位,输出 aarch64 就是 ARM64 位。
| 你的电脑情况 | 推荐安装包 | 优点 |
|---|---|---|
| macOS 系统用户 Intel 芯片的 Mac(如旧款 MacBook Pro/Air) | macOS 64-bit Installer (.pkg) | 图形化安装,自动配置环境变量,适合新手 |
| Apple Silicon 芯片的 Mac(M1/M2/M3 系列) | macOS Apple Silicon 64-bit Binary (.tar.gz) | 针对苹果自研芯片优化,性能更好 |
| 不想安装,仅临时使用 | 对应芯片的 .tar.gz 二进制包 | 解压后手动配置环境变量即可使用 |
注意:快速判断你的 Mac 芯片:点击左上角苹果图标 → 「关于本机」,查看「芯片」一栏,显示「Apple Mx」就是 Apple Silicon,显示「Intel Core」就是 Intel 芯片。
| 你的电脑情况 | 推荐安装包 | 优点 |
|---|---|---|
| Windows 系统用户普通笔记本 / 台式机(x86_64 架构,绝大多数 Windows 10/11 设备) | Windows 64-bit Installer (.msi) | 带图形化安装向导,自动配置环境变量,最省心,适合安装 Hexo |
| 搭载 ARM 芯片的 Windows 设备(如 Surface Pro X、部分轻薄本) | Windows ARM 64-bit Installer (.msi) | 针对 ARM 架构优化,安装流程和普通版本一致 |
| 不想安装,仅临时使用 | Windows 64-bit Binary (.exe) | 绿色解压版,无需安装,解压后直接运行 |
注意:快速判断你的 Windows 架构:打开「设置 → 系统 → 关于」,查看「系统类型」,显示「64 位操作系统,基于 x64 的处理器」就是普通 64 位;显示「基于 ARM 的处理器」就是 ARM 64 位。
双击下载的文件。

点击 Next.

这是 Node.js 安装过程中的最终用户许可协议(End-User License Agreement,EULA)页面。
下一步操作:直接点击右下角的 Next 按钮,就能进入下一步的安装路径选择界面了。

根据自己需求选择安装位置,一般不建议安装在 C 盘。

这是 Node.js 安装过程中的自定义安装配置界面,各选项说明如下:
node、npm 等命令。当前界面的默认勾选配置已经是最优选择,不需要修改任何选项,直接点击右下角的 Next 按钮继续安装流程即可。

这是 Node.js 安装中的原生模块编译工具配置界面:
这个选项是用来安装编译 C/C++ 原生模块所需的工具(如 Python、Visual Studio Build Tools),仅当你需要安装依赖原生代码的 npm 包时才需要。
Hexo 及其依赖都是纯 JavaScript 编写的,完全不需要编译原生模块,因此:
Next 按钮,继续完成安装即可。后续问题处理:如果之后你安装其他 npm 包时遇到'需要编译原生模块'的错误,再根据提示手动安装这些工具也完全来得及。

直接点击 install 即可。

等待安装即可。

安装完成,点击 finish 或者点击叉掉。

打开电脑终端(Windows 用 cmd/PowerShell,Mac/Linux 用 Terminal),输入:
node -v
npm -v
运行能看到版本号就说明安装成功。

把本地博客代码推送到 GitHub 仓库,实现部署。
打开 Git 官网:https://git-scm.com/
点击页面中间的 Download for Windows(Windows 用户),会自动下载最新稳定版安装包。



这是 Git 安装向导的第一步,你只需要点击 Next 按钮继续就可以了。

根据自己的选择,选择安装地址。

介绍各个选项:
Additional icons → On the Desktop
Windows Explorer integration
Git LFS (Large File Support)
Associate .git configuration files with the default text editor
.gitconfig、.gitignore 等 Git 配置文件,默认用你指定的编辑器(如 VS Code)打开。Associate .sh files to be run with Bash
.sh 格式的 Shell 脚本文件,默认用 Git Bash 来运行。Check daily for Git for Windows updates
Add a Git Bash Profile to Windows Terminal
Scalar (Git add-on to manage large-scale repositories)

这个界面是在设置 Git 程序在 Windows「开始菜单」中的快捷方式存放位置。保持默认最清晰。

这个界面是让你选择 Git 在需要编辑文本时(比如写提交信息、修改配置文件)默认使用的编辑器。

这个界面是设置你用 git init 新建仓库时,默认的主分支名称。
master)作为新仓库的初始分支。main。
这个界面是设置 Git 在系统中的可访问方式,也就是调整环境变量 PATH。
PATH 中。你可以在 Git Bash、Command Prompt、PowerShell 等各种终端里使用 Git 命令,同时第三方软件(如 Hexo)也能正常找到 Git。PATH 中,可能引发冲突。新手不建议选择。
这个界面是让你选择 Git 连接远程仓库(比如 GitHub)时使用的 SSH 客户端程序。

这个界面是选择 Git 建立 HTTPS 连接时使用的 SSL/TLS 加密库。

这个界面是配置 Git 如何处理文本文件中的换行符。

这个界面是为 Git Bash 选择终端模拟器。

这个界面是设置 git pull 命令的默认行为。
这个界面是选择 Git 的凭证助手。

选项说明:



安装完成。
在桌面空白处点击右键 → 选择 Git Bash Here(这是最方便的打开方式)。

在打开的 Git Bash 窗口里,输入以下两行命令(记得把内容换成你自己的):
# 替换成你的 GitHub 用户名
git config --global user.name "你的 GitHub 用户名"
# 替换成你 GitHub 绑定的邮箱
git config --global user.email "你的 GitHub 邮箱@xxx.com"

验证配置是否成功:输入这条命令查看已配置的信息:
git config --global --list
验证 Git 安装是否正常:输入这条命令,查看 Git 版本:
git --version

前置准备:检查必备工具(已装 Git/Node.js 可直接跳)
Hexo 依赖Git和Node.js,必须先装且能正常使用,验证步骤:
git --version,回车→显示版本号(如 git version 2.52.0.windows.1)= Git 正常node -v,回车→显示版本号(如 v18.18.2)= Node.js 正常npm -v,回车→显示版本号(如 9.8.1)= npm 包管理器正常(npm 是安装 Node.js 时自动附带的,无需单独装)npm install -g hexo-cli
hexo -v,回车→显示 Hexo 版本号(如 hexo-cli: 4.3.0)= Hexo 安装成功
比如:在D 盘新建一个文件夹,命名为 HexoBlog(右键→新建→文件夹,命名为 HexoBlog),路径为 D:\HexoBlog
D:
cd HexoBlog
(验证:输入 dir,回车→能看到文件夹内内容(目前为空),即路径切换成功)

在当前 D:\HexoBlog 路径下,复制以下命令粘贴回车:
hexo init
npm install,等待即可初始化后,在同一文件夹路径(D:\HexoBlog)下,依次执行以下 2 个命令,启动本地博客预览:
复制命令粘贴回车:
hexo g
(g是 generate 的简写,生成博客所需的静态 HTML 文件,无报错即成功)
复制命令粘贴回车:
hexo s
(s是 server 的简写,启动本地服务器,最后显示「Hexo is running at http://localhost:4000/ Press Ctrl+C to stop.」即成功)

打开任意浏览器(Chrome/Edge/360),在地址栏输入:http://localhost:4000,回车→看到Hexo 默认博客页面(有 Hello World 文章、分类 / 标签侧边栏)= 安装 + 初始化全部成功!
测试完成后,回到 CMD/PowerShell,按键盘Ctrl+C,回车→即可停止服务器,恢复命令输入。
注意:需要测试完成之后才能关闭命令行窗口!!!
重要补充:新手必记的 3 个常用简写命令
| 完整命令 | 简写命令 | 作用 |
|---|---|---|
| hexo generate | hexo g | 生成静态博客文件 |
| hexo server | hexo s | 启动本地预览服务器 |
| hexo clean | hexo c | 清理已生成的静态文件(出错时先执行这个) |
hexo s 后,浏览器访问 http://localhost:4000 打不开→检查 CMD 是否显示服务器启动成功,关闭浏览器重新访问,或换个浏览器hexo c 清理,再重新执行 hexo g 和 hexo sHexoBlog 文件夹是新建的空文件夹,无任何其他文件 / 子文件夹你的 D:\HexoBlog 文件夹内会出现 Hexo 默认目录结构,核心文件夹:
source:存放你的博客文章(.md 格式)themes:存放博客主题(后续换主题用)public:生成的静态博客文件(部署到服务器时用)这一步是Hexo 博客的核心配置环节,修改的是 Hexo 根目录下的 _config.yml 文件。
用 VS Code 打开 hexo-blog 文件夹,找到根目录的 _config.yml 文件(这是 Hexo 的核心配置文件),修改以下内容:
# Site title: 我的博客
# 博客标题
subtitle: 记录技术学习与思考
# 副标题
description: 专注技术入门与实战
# 博客描述(SEO 用)
author: 你的名字
# 作者名
language: zh-CN
# 语言设置为中文
timezone: Asia/Shanghai
# 时区设置为上海
在文件末尾找到 Deployment 部分,修改为:
# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
type: git
repo: [email protected]:你的 GitHub 用户名/你的 GitHub 用户名.github.io.git
branch: gh-pages
repo 是你的 GitHub 仓库地址(必须用 SSH 格式,后面会教你配置 SSH 密钥)branch 固定为 gh-pages(GitHub Pages 会从这个分支拉取静态文件)改好后,执行 hexo g -d(生成静态文件 + 部署)命令,Hexo 会自动把本地的博客文件推到你 GitHub 的 用户名.github.io 仓库的 gh-pages 分支,之后别人就能通过 https://你的 GitHub 用户名.github.io 访问你的博客了。
打开终端(Windows 用 CMD / 终端、Mac 用 Terminal),切换到你的 Hexo 项目文件夹路径,执行命令:
hexo new "我用 NumPy 实现了 KNN 算法"
# 新建一篇标题为'我用 NumPy 实现了 KNN 算法'的文章
✅ 效果:文章会以 Markdown 格式(.md 文件) 生成在项目的 source/_posts 文件夹中。
在 VS Code 中打开 source/_posts 文件夹,找到刚生成的 我用 NumPy 实现了 KNN 算法.md 文件,用 Markdown 语法编辑内容(支持标题、代码块、图片等)。
示例(Markdown 内容):
# 我用 NumPy 实现了 KNN 算法
今天分享如何用 NumPy 手写 KNN 分类算法:
## 1. 核心原理
KNN 是基于'近邻投票'的分类算法...
## 2. 代码实现
```python
import numpy as np
def knn_predict(X_train, y_train, X_test, k=3):
# 实现逻辑 pass
### 4.3 生成静态文件
编辑完成后,在终端执行命令,将 Markdown 文章生成浏览器可访问的静态 HTML 文件:
```bash
hexo generate
# 简写:hexo g
✅ 效果:生成的静态文件会存放在项目的 public 文件夹中。
这一步需结合 GitHub 仓库、SSH 密钥配置,确保博客推送到 GitHub 并在线可访问:
你的 GitHub 用户名.github.io(与账号名完全一致,错 1 个字符都不行);Windows 系统需额外执行「启用 SSH 代理 + 加载私钥」,Mac/Linux 可跳过这部分:
C:\Users\你的系统用户名\.ssh\ 文件夹,用记事本打开 id_ed25519.pub,全选复制内容;cat ~/.ssh/id_ed25519.pub,复制输出内容;我的笔记本);Windows 系统:启用并启动 SSH 代理 + 加载私钥:在管理员 CMD 中执行(解决权限问题):
sc config ssh-agent start= auto
net start ssh-agent
ssh-add C:\Users\你的系统用户名\.ssh\id_ed25519
生成 SSH 密钥:打开终端(管理员身份运行 CMD),执行命令(替换为你的 GitHub 绑定邮箱):
ssh-keygen -t ed25519 -C "你的 GitHub 绑定邮箱"
连续按 3 次回车(默认生成路径:C:\Users\你的系统用户名\.ssh\)。
在终端的 Hexo 项目路径下,执行命令(安装 Git 部署插件):
npm install hexo-deployer-git --save
在终端的 Hexo 项目路径下,执行清理缓存 + 生成静态文件 + 部署的合并命令(避免旧文件残留):
hexo clean && hexo generate && hexo deploy
# 简写:hexo c && hexo g && hexo d
✅ 部署成功标志:终端最后显示 Deploy done: git。
gh-pages 分支;打开浏览器,输入地址:
https://你的 GitHub 用户名.github.io
✅ 首次访问需等待 10-30 分钟(GitHub 解析 DNS / 同步 CDN),之后刷新即可正常访问。
每次写新文章 / 修改内容后,仅需在终端执行:
hexo new "新文章标题" # 新建文章→编辑内容
hexo c && hexo g && hexo d # 一键部署更新

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online