如何新建一个个人网站（1）

此文章记录了如何新建一个个人网站，并使用Hexo搭建博客。

并且附上作者踩过的无数坑（）
此文章仅用于windows系统，采用hexo+github搭建个人博客（非常适合小白）
在开始之前，请确保你已经拥有一个github账号

1. 安装Node.js和npm

进入Node 官网下载安装包，安装完成后，在终端中输入以下命令查看版本：

node -v && npm -v #若显示对应版本号则安装成功

2. 安装Git

进入Git 下载安装包，安装完成后，在终端中输入以下命令查看版本：

git --version #若显示对应版本号则安装成功

注意：

Git官网国内访问速度较慢，可自行网络搜索镜像源。
Git的安装路径中不要有中文，否则会导致后续步骤报错
Git需要设置用户名和邮箱，否则无法提交代码到远程仓库

如何设置用户名和邮箱

git config --global user.name "your name"    #“your name”替换为你github的用户名
git config --global user.email "your email"     #“your email”替换为github注册的邮箱

查看你的用户名和邮箱

git config --global user.name
git config --global user.email

3. npm换源

由于某些不可说原因（），npm的源会很慢，我们可以换成淘宝的源，这样安装速度会快很多。

npm config set registry https://registry.npmmirror.com

-请注意，本文章的淘宝镜像源更新时间为2024年10月11日，若之后npm源更新，请自行更换。
-如果你有科学上网工具，也建议使用镜像源，这样安装速度快且方便。

4. 代码编辑器vscode推荐

vscode是一款开源的跨平台代码编辑器，功能强大且轻量，适合编写各种语言代码。

下载安装：https://code.visualstudio.com/
与vs2019和2022不是一种软件
你也可以采用自己的代码编辑器，在此仅作个人推荐

5. Hexo的安装

-安装过程参考官方文档，本文仅做部分简要说明和报错处理
Hexo官方文档：https://hexo.io/zh-cn/

在终端中输入以下命令安装Hexo：

npm install -g hexo-cli

安装完成后我们输入以下命令查看Hexo是否安装成功：

hexo -v #若显示对应版本号则安装成功

这样，Hexo就安装成功了。

6. Hexo的初始化

首先你需要找一个你自己的盘建一个文件夹，比如d:\myblog，然后进入该文件夹。

打开CMD，输入命令切换目录：

cd d:\myblog

在终端中输入以下命令建立Hexo项目：

hexo init 

注意，此处若出现【fatal: unable to access ‘xxx’: OpenSSL SSL_read: SSL_ERROR_SYSCALL, errno 0】报错，即为网络问题，请切换淘宝镜像源解决。
若出现【Start blogging with Hexo!】即为初始化成功。

安装完成后，文件夹结构如下所示：

.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

这时候你就可以在本地查看你的博客了，输入：

hexo s

如果出现安全提示，选择允许访问即可。

按crtl+左键点击链接，即可在浏览器中查看你的本地博客。

7.上传你的博客至github

首先你需要注册一个github账号，然后创建一个仓库，仓库名为”你的github用户名”.github.io。
-仓库好像要设为public可见，空的就好，不要建任何文件

连接本地Git仓库与远程仓库

打开本地git bash，输入以下命令：

git config --global user.name "username"   # username是你的GitHub用户名，注意大小写
git config --global user.email "email"     # email是注册 GitHub的邮箱
ssh-keygen -t ed25519 -C "email"           # 生成ed25519密钥对，email同上

默认密钥对在用户目录的 .ssh 目录下，在该目录你可以看到 id_rsa 和 id_rsa.pub ，使用文本编辑器打开 id_rsa.pub 文件并复制
打开GitHub，点击右上角头像，选择 Settings -> SSH and GPG keys -> New SSH key，将复制的公钥粘贴到Key中，Title随便填，然后点击Add SSH key。
回到本地Git bash，输入以下命令：

ssh -T git@github.com     

-出现一个hostname 提示输入 yes 回车
-ps：看见 “Hi username! You’ve successfully authenticated, but GitHub does not provide shell access.” 则说明连接成功

最后修改修改 Blog 目录下的 Hexo 全局配置文件 _config.yml 的 deploy 字段

deploy:
  type: git   # 部署类型
  repo: https://github.com/username/username.github.io.git   # username是Github用户名
  branch: master   # 远程分支

ok，接下来就可以推送文件到远程仓库了，继续打开你的git bash，切换到你的博客文件夹，输入以下命令：

hexo clean   # 清除缓存
hexo g      # 生成静态文件
hexo d      # 部署到远程仓库

前面都没问题的话，现在你的博客应该推送到 GitHub 仓库了，打开 Github你仓库的settings，左侧找到pages，注意对应仓库的分支和路径，选master（我们部署的分支）-/（root），然后点击save。

好了接下来你就可以通过 https://【username】.github.io 访问你的博客了。

– 有关于主题美化和个人域名绑定，后续会持续更新>.<
– 有问题私戳我=-=