Welcome to Hexo! This is your very first post. Check documentation for more info. If you get any problems when using Hexo, you can find the answer in troubleshooting or you can ask me on GitHub.
1 | $ hexo new "My New Post" |
More info: Writing
1 | $ hexo server |
More info: Server
1 | $ hexo generate |
More info: Generating
1 | $ hexo deploy |
More info: Deployment
一、本地初始化 Hexo 博客
全局安装 Hexo 脚手架，需要安装好node js
npm install -g hexo-cli
初始化 Hexo 模板
hexo init .
安装依赖
npm install
本地预览： 此时输入 hexo s 或者 hexo server | npx hexo server，并在浏览器打开 http://localhost:4000，即可看到你的博客页面。在终端按 Ctrl + C 可停止预览。
hexo server
二、hexo的一些基本操作
新建一篇文章
hexo new “我的第一篇文章” 或者 hexo n “我的第一篇文章”
文章会出现在 source_posts文件夹中。用编辑器打开 Markdown 文件，在第二个 — 后写正文，再次运行下面的命令即可预览。
重新生成内容
hexo clear
hexo generate
hexo server
上述命令也可以简写为
hexo cl
hexo g
hexo s
成功后会生成 public 文件夹。Cloudflare Pages 做的事情，本质上就是在云端重复构建博客内容并发布。
三、配置 GitHub 私有仓库
本地初始化 Git 仓库
在博客根目录下执行：
git init
git add .
git commit -m “初始化我的博客”
建立 GitHub 私有仓库
推送代码到github
使用 SSH 密钥，以后 push 不用输入密码，不受 https 密码认证限制。
PowerShell 生成密钥：
ssh-keygen -t ed25519 -C “2046641767@qq.com“
一路回车，不要设置密码。
打开 C:\Users\20466.ssh\id_ed25519.pub(修改为自己电脑的路径)复制全部公钥内容。
GitHub 网页：Settings → SSH and GPG keys → New SSH key，粘贴公钥保存。
修改本地 git 远程地址为 SSH 格式：
git remote add origin https://github.com/你的用户名/你的仓库名.git
git remote add origin git@github.com:bert-wen/yixing.git
git branch -M main
5. 推送
git push -u origin main
四、配置 Cloudflare Pages 自动化部署
创建 Pages 项目
核心构建参数配置（关键步骤）
在设置页面，请严格按照以下参数填写：
项目名称： 保持默认（或自定义）
生产分支： main
框架预设 (Framework preset)： 选择 None（保持未选择状态）
构建命令 (Build command)： 填入 npx hexo generate 或者 npx hexo clean && npx hexo generate
构建输出目录 (Build output directory)： 填入 public
根目录 (Root directory)： 保持留空，不用填写。
构建命令务必填写 npx hexo generate 或 npx hexo g 或 npx hexo clean && npx hexo generate，不要写为 npm hexo generate 或 npm run build
极重要：配置环境变量
由于 Hexo 新版本需要较高版本的 Node.js 环境，必须手动指定：
在当前页面下方展开 环境变量（高级） 区域。
点击 添加变量：
变量名称 (Variable name)： NODE_VERSION
值 (Value)： 24 (直接填大版本号即可) 版本号一定要和本地node版本保持一致，本地node版本号使用命令 node -v 查看
点击最下方的 保存并部署。
大功告成！ 几分钟后，Cloudflare 就会提示部署成功，并会为你分配一个免费的 xxx.pages.dev 专属二级域名，点击即可访问你的个人博客！