这个教程涵盖了我搭建博客时遇到的所有问题，希望能够帮到你


准备工作

需要下载以下软件

node.js

Git

魔法上网 可以用Steam++访问github


Git的配置

装好Git以后，右键菜单就会出现如图选项，进入Git控制台

第一件事就是配置用户名和邮箱

1
2
3
4
# 配置用户名
git config --global user.name WinkySpeed	
# 配置邮箱	~~此处邮箱可以实际上不存在~~
git config --global user.email WinkySpeed@test.mail


如图



进行hexo的配置与搭建

查看nodejs是否安装成功

以管理员身份打开cmd

如图，输入 node -v 和 npm -v 查看版本

国内的源可能有些慢，最好利用淘宝的源，控制台输入

1
npm install -g cnpm --registry=https://registry.npm.taobao.org

等安装成功后输入 cnpm -v 如果能查出版本号说明安装成功


下载hexo

控制台输入

1
cnpm install -g hexo-cli

等待安装

用 hexo -v 验证


使用hexo正式搭建博客

建立一个Blog文件夹，以后的控制台操作都会在此文件夹内进行，如果搭建博客过程中出现问题，可以直接把该文件夹删除重来

使用cd指令进入对应的Blog文件夹，在控制台输入

1
hexo init

此处大概会出现两种错误：

一种是没安装Git或没初始化，无法clone，如图

一种是网络问题，无法正常clone，如图，提示 Failed to connect to github.com port 443


如果是Git的问题，照着之前的教程再做一遍即可

网络问题就需要科学上网了，打开steam++选择github加速，加速模式选择系统代理模式

可以看到，挂了加速以后可以连上github了

此时再 hexo init 一次试试，发现仍不行，还是报错，但是都能上github了，为什么不能clone呢？

原因是Git没有启用代理，右键打开右下角网络，选择“网络和Internet设置”，左边选择“代理”

注意到这里

地址应该都是本机回送地址，但是端口可能会不一样，得看不同科学上网软件了，记住这个端口: 26501

右键打开Git控制台

如图输入


1
2
3
git config --global http.proxy 127.0.0.1:26501

git config --global https.proxy 127.0.0.1:26501

端口26501就是上文中出现的端口，不同魔法上网软件的端口是不一样的，按自己机子上显示的来

这样就可以解决 Failed to connect to github.com port 443 问题

回到控制台，再次输入 hexo init 应该就可以正常进行了


但是有时可能出现下图错误

报错为 SSL certificate problem: unable to get local issuer certificate

解决方法为，通过命令关闭SSL证书验证

在Git控制台输入

1
git config --global http.sslverify false


此时再回到Blog目录下的控制台，也可以在Blog目录里打开Git控制台，输入 hexo init

经过漫长的等待，hexo终于装好了


启动博客

在Blog目录下的控制台输入

1
hexo s


现在hexo就在回送地址的4000端口显示了，在浏览器中输入

http://localhost:4000/ 或 127.0.0.1:4000

hexo就会自动生成

美化是后面的事，最重要的是先拥有一个属于自己的博客

控制台中Ctrl + C可以退出hexo，输入

1
hexo n "第一篇博客test"


进入 Blog_posts 中，就会发现hexo帮你生成了一篇博客，后缀名是.md

文章采用Markdown语法，推荐使用Typora编辑，不过现在收费了，可以使用破解版

随便写一写保存退出，再通过hexo s启动，就可以看到新写的博客发布在上面了



把博客部署到github上

新建github仓库

打开github新建一个仓库

仓库名一定要是自己github的用户名+.github.io

例如我的就是 WinkySpeed.github.io


安装Git部署插件

成功创建仓库后，在Blog目录下打开控制台，安装Git部署插件，输入

1
cnpm install --save hexo-deployer-git

如图显示则安装成功


配置config

进入Blog目录，设置 _config.yml 文件，用记事本或vscode打开都可以

拉到最底下找到 # Deployment

修改如下，保存退出

1
2
3
4
5
6
# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: git
  repo: https://github.com/WinkySpeed/WinkySpeed.github.io.git
  branch: master

repo: 后的地址就是刚刚建立的github仓库地址，可以在仓库里获取


部署至Github

回到Blog目录下的控制台，输入

1
hexo d

中途会跳出github的登陆界面，在里面输入账号密码就可以了

如图显示则成功

回到github仓库刷新，就发现仓库里有内容了

在浏览器中输入你的博客地址，就可以访问部署到远端的博客了

如果没成功，可以多刷新几次，等待github检查代码，成功时会有个小绿勾，就可以正常访问了

如果实在不行，就把github库删了重新建一个新库，重新推就行了



Hexo指令

1
2
3
4
5
6
7
8
9
10
# 本地预览，可以在回送地址预览自己的博客
hexo s
# 新建博文，双引号内字符串为标题
hexo n ""
# 清理缓存
hexo clean
# 生成文件
hexo g
# 部署到远端
hexo d

每次做出修改，在Blog目录下打开控制台，依次输入

1
2
3
hexo clean
hexo g 
hexo d

就可以完成一次推送

推送中可能出现的问题：

fatal: detected dubious ownership in repository at xxx

原因：一开始部署博客的时候是用的管理员身份运行的cmd，这里我是直接在blog目录下打开的cmd，不是管理员身份

解决方法：通过管理员身份打开cmd后cd到blog目录下，重新hexo d即可



关于美化

这次的目的是帮助大家建立一个属于自己的博客，至于美化就看个人了，可以参考别人的博客，个性化自己的




参考教程

『教程』简单明了的Git入门

手把手教你从0开始搭建自己的个人博客 |无坑版视频教程| hexo

Git报错： Failed to connect to github.com port 443 解决方案

使用git克隆仓库到本地报错：SSL certificate problem: unable to get local issuer certificate