1.如何在 Windows 系统下创建博客-平芜编程栈

如何在 Windows 系统下创建博客

本文借鉴于"爱扑 bug 的熊"，仅作为 Windows 系统搭建博客的补充记录。
原文链接：点击跳转
文章作者：睡觉时不困

博客是个人输出的最好途径之一。一个属于自己的独立博客，不仅可以沉淀知识，还能作为一张"个人名片"。本文记录我从零搭建一个 Hexo 静态博客，并配合 GitHub、Netlify、CloudFlare 上线、配域名、配 HTTPS 的完整流程。

整个过程完全免费，只要你有一个能上网的 Windows 电脑 + 一个稳定的 VPN + 一个 Google 账号 + 一个 GitHub 账号。

0. 前置准备

0.1 必备工具

工具	用途	下载地址
VPN（稳定）	访问 GitHub、Netlify、CloudFlare	自备
Google 账号	注册 Netlify / CloudFlare	https://google.com
GitHub 账号	代码托管 + 触发 Netlify 自动部署	https://github.com
Go	Hexo 依赖（早期需要）	https://go.dev/doc/install
Git	推送代码到 GitHub	https://git-scm.com/downloads/win
Node.js	Hexo 运行环境 + npm	https://nodejs.org/en/download

0.2 基础命令行速查（cmd）

为了方便后续操作，先熟悉几个常用命令：

命令	说明	示例
`盘符名称 + 冒号`	切换盘符	`E:`
`dir`	查看当前路径下的内容	`dir`
`cd 目录`	进入单级目录	`cd itheima`
`cd 目录1\目录2\...`	进入多级目录	`cd itheima\JavaSE`
`cd ..`	退回上一级目录	`cd ..`
`cd \`	退回盘符根目录	`cd \`
`cls`	清屏	`cls`
`exit`	退出终端	`exit`

0.3 验证安装

Win + R→ 输入cmd打开终端，依次执行：

node-vnpm-vgit--version

只要都出现版本号就 OK 了。

一、安装 Hexo

全局安装 Hexo 命令行工具：

npminstallhexo-cli-g

可能遇到的问题：镜像源配置

下载过程中如果报错，多半是 npm 镜像源问题。解决方案：

# 重置为官方源npmconfigsetregistry https://registry.npmjs.org/# 或者切换到国内淘宝源npmconfigsetregistry https://registry.npmmirror.com

查看当前镜像源是否正确：

npmconfig get registry

返回https://registry.npmjs.org/或https://registry.npmmirror.com即可。这两个源只能保留一个，不要混用。

设置好后重新执行npm install hexo-cli -g，看到正常下载日志即成功。

二、初始化博客项目

2.1 创建博客目录

在 C 盘用户目录下新建一个Blog文件夹。建议直接放 C 盘，其他盘符可能会有权限限制，反而麻烦。

2.2 初始化

hexo init"C:\Users\你的用户名\Blog"

执行后会自动从 GitHub 克隆hexo-starter模板，安装依赖：

INFO Cloning hexo-starter https://github.com/hexojs/hexo-starter.git INFO Install dependencies INFO Start blogging with Hexo!

看到Start blogging with Hexo!就成功了。

2.3 安装其余依赖

cd"C:\Users\你的用户名\Blog"npminstall

2.4 本地预览

hexo server

浏览器打开 http://localhost:4000，看到 Hexo 默认界面说明本地跑起来了。

2.5 给 package.json 加一条快捷命令

打开 Blog 文件夹里的package.json，在scripts里加上"netlify"这一行：

"scripts":{"build":"hexo generate","clean":"hexo clean","deploy":"hexo deploy","server":"hexo server","netlify":"npm run clean && npm run build"// 新加这一行}

这一行后面 Netlify 建站时要用到，提前配好省事。

三、推送到 GitHub

3.1 创建 GitHub 仓库

打开 https://github.com/，右上角加号 →New repository，给仓库起个名字（建议英文小写，比如my-blog），点击Create repository。

3.2 本地推送到远程

# 进入博客目录cd"你的博客目录路径"# 初始化 Gitgitinit# 添加所有文件gitadd.# 提交gitcommit-m"my blog first commit"# 添加远程仓库地址（替换为你的仓库 URL）gitremoteaddorigin https://github.com/你的用户名/你的仓库名.git# 重命名默认分支为 maingitbranch-Mmain# 推送gitpush-uorigin main

3.3 首次推送认证

第一次推送 GitHub 会要求登录：

HTTPS 地址：终端会提示输入 GitHub 用户名和密码（推荐用 Personal Access Token 当密码）
SSH 地址：如果你配置过 SSH 密钥则直接通过

3.4 常见坑

坑 1：远程仓库没添加成功

gitremote-v

如果没显示你的 GitHub 地址，重新执行：

gitremoteaddorigin https://github.com/你的用户名/你的仓库名.gitgitpush-uorigin main

正确结果类似：

origin https://github.com/quanshuyang/mu-blog (fetch) origin https://github.com/quanshuyang/mu-blog (push)

坑 2：开了 VPN 也推送失败

让 Git 走代理（端口根据你的 VPN 客户端调整，常见是 7890）：

gitconfig--globalhttp.proxy http://127.0.0.1:7890gitconfig--globalhttps.proxy http://127.0.0.1:7890

然后再次git push -u origin main。

认证通过后终端出现推送成功日志，说明代码已经上云了。

四、用 Netlify 建站

Netlify 提供免费的静态网站托管服务，能自动从 GitHub 拉取代码并构建。

4.1 注册并登录

打开 https://www.netlify.com/，用 GitHub 账号一键登录（这一步需要 VPN）。

4.2 新建站点

进入控制台，点击Add new site→Import an existing project
选择GitHub，授权 Netlify 访问你的仓库
选中刚才创建的my-blog仓库

4.3 配置构建命令

这一步很关键，填错就构建失败：

配置项	填写内容
Base directory	留空
Build command	`npm run netlify`
Publish directory	`public`
Functions directory	`netlify/functions`

这里npm run netlify就是前面在package.json里加的那条命令，本质是npm run clean && npm run build，确保每次部署都是干净的状态。

4.4 部署

点击Deploy mu-blog，等待几分钟后 Netlify 会自动构建完成，并给你一个免费域名，例如blog-qsy.netlify.app。

打开它，看到 Hexo 默认首页，博客就上线了。

五、绑定自定义域名

免费的.netlify.app域名虽然能用，但太丑了。咱们花点小钱买个自己的域名。

5.1 购买域名

国内首推阿里云万网：https://wanwang.aliyun.com/

选个自己喜欢的后缀（.cn、.com、.top等），价格从几块到几十块一年不等。购买后会要求创建模板、提交审核（注意：不是实名认证，后续还要单独做）。

5.2 配置域名解析

在阿里云域名控制台 → 域名列表 → 找到你的域名 → 解析设置：

主机记录	记录类型	记录值
`@`	CNAME	`你的域名.netlify.app`
`www`	CNAME	`你的域名.netlify.app`

记录值就是 Netlify 给你分配的免费域名。

⚠️ DNS 全球同步需要一段时间（通常几分钟到几小时），耐心等。

5.3 在 Netlify 添加自定义域名

回到 Netlify 站点设置 →Domain management→Custom domains→ 添加你的域名。

因为前面已经做过解析，一路默认下一步就行。

5.4 启用 Netlify 全球 CDN

在 Netlify 域名设置里点击Netlify DNS，启用即可。这一步能让博客通过 Netlify 的海外 CDN 节点分发，访问更快。

六、用 CloudFlare 加速

6.1 注册 CloudFlare

打开 https://www.cloudflare.com/zh-cn/plans/，注册账号并登录。

6.2 添加站点

输入你的域名，选择免费套餐。

6.3 添加 DNS 记录

CloudFlare 通常会自动扫描到几条记录。重点检查CNAME 记录（指向 Netlify 的那条），缺失的话手动补上。

6.4 更改名称服务器

这一步 CloudFlare 会给教程，核心是把阿里云默认的 DNS 服务器改成 CloudFlare 的：

打开阿里云域名控制台 → 域名列表
找到你的域名 → DNS 修改
把两个 DNS 服务器地址替换为 CloudFlare 提供的（如xxx.ns.cloudflare.com）
提交

CloudFlare 会发邮件通知配置完成。

七、配置 HTTPS

回到 Netlify，配置完成后 CloudFlare 会自动签发证书。

7.1 确认 DNS 解析

Netlify →Domain settings→HTTPS→ 确认解析已经生效。

7.2 自动安装证书

Netlify 会通过 Let’s Encrypt 自动签发证书，等待一段时间后看到绿色对勾就说明 HTTPS 配置完成了。

八、验证成果

打开你自己的域名（例如 https://blog.quanshuyang.cn），看到 Hexo 默认的星空界面，说明博客已经全部配置成功！
可以试着在不开 VPN的情况下访问，能正常打开就代表一切顺利。

九、写在最后

到这里，一个独立的、带自定义域名 + HTTPS + CDN 加速的个人博客就彻底搭建完成了。整个流程零成本（除了域名年费），非常适合作为长期输出的载体。

后续可以做什么

换主题：Hexo 官方有大量主题（Next、Butterfly、Yilia 等），可以在_config.yml里切换。
写文章：执行hexo new "文章名"，在source/_posts/下编辑 markdown 文件。
配评论系统：接入 Gitalk、Waline、Twikoo 等。
图床：用 GitHub + jsDelivr 或腾讯云 COS 做图片托管。

Hexo 博客的写作方法、主题配置、插件扩展内容很多，建议去 Hexo 官方文档自己摸索，遇到问题再来搜。

我以后也会不定期更新博客，分享自己学到的知识和所见所闻。

欢迎大家持续关注！

附录：常用命令速查

操作	命令
新建文章	`hexo new "标题"`
本地预览	`hexo server`
清理缓存	`hexo clean`
生成静态文件	`hexo generate`
部署到 Netlify	`npm run netlify`
推送代码到 GitHub	`git add . && git commit -m "msg" && git push`

📌 关键命令汇总：

# 第一次安装npminstallhexo-cli-ghexo init"C:\Users\你的用户名\Blog"cd"C:\Users\你的用户名\Blog"npminstall# 本地预览hexo server# 推送到 GitHubgitadd.gitcommit-m"update"gitpush