利用 Github Pages 和 Hexo 搭建博客常见问题解决

欢迎各位大佬来参观我的博客：AmosMeer’s Blog
搭建过程中出现的任何问题请参考博客：常见问题解决
完整的博客搭建过程的文章汇总：

1. 利用 Github Pages 和 Hexo 初步搭建博客
2. 博客的美化配置（NexT主题）
3. 博客的功能配置
4. 利用 Github Pages 和 Hexo 搭建博客常见问题解决
5. 常见 Hexo 命令

常见问题

说明：
hexo 下的 _config.yml 称为站点配置文件
themes/next 中 的_config.yml 称为主题配置文件

语言不生效问题

根据官方文档描述：

语言	代码	设定示例
English	en	language: en
简体中文	zh-Hans	language: zh-Hans
Français	fr-FR	language: fr-FR
Português	pt	language: pt or language: pt-BR
繁體中文	zh-hk 或者 zh-tw	language: zh-hk
Русский	язык	ru language: ru
Deutsch	de	language: de
日本語	ja	language: ja
Indonesian	id	language: id
Korean	ko	language: ko

在站点配置文件中设置语言

language: zh-Hans // 这里设置语言为 简体中文

如果不起作用的话，查看 themes/next/languages/ 目录下是否有zh-Hans.yml 文件。如果没有的话需要把 zh-CN.yml 文件改成名字为 zh-Hans.yml 就可以了。

出现 npm: command not found

有 git bash，也安装了 node.js, 但是在运行 bash 时依旧会报错 npm: command not found
解决方案：
需要改成全局安装。
npm install grunt ：本地安装
npm install -g grunt-cli ：全局安装
在cmd 下输入以下内容就可以了：

npm install -g grunt-cli

创建新的SSH密钥时创建失败

解决方案：如果创建位置位于C盘，可以尝试以管理员的身份运行 Git Bash Here

出现 bash: cd: too many arguments

命令中存在空格，如果是不必要空格直接删掉就好，若果是路径名或者变量中间有空格时，需要用双引号括起来。

Git 密钥认证 github 时出现错误

$ ssh -T git@github.com
The authenticity of host ‘github.com (192.30.255.112)’ can’t be established.
RSA key fingerprint is SHA256:nThbg6kXUpJWGl7E1IGOCspRomTxdCARLviKY8.
Are you sure you want to continue connecting (yes/no)?

解决方案：
直接输入 yes 回车，这时在ssh目录下除 id_rsa，id_rsa.pub 文件外，还会生成一个know_hosts 文件。

出现 ERROR Deployer not found: git

执行 hexo g -d 时出现报错 ERROR Deployer not found: git，说明你的 deployer 没有安装成功，需要执行如下命令再安装一次：

npm install hexo-deployer-git --save

这样，再执行 hexo g -d，博客就部署到 Github 上了

hexo更换主题后出现 WARN No layout: index.html

解决方案：

• 检查下载的主题是不是放在了 themes 文件夹下面。比如 next 主题的放置，就是点开 themes 就看到 next 的文件夹，next 下面就是主题的文件，不能打开 next 文件夹里面还有 themes。

• 检查站点配置 _config.yml 是否正确：theme: 主题名字

  • 这里是 theme，不是themes
  • theme 与主题名直接有一个空格（冒号后面有空格）
  • 主题名字是否与themes文件夹下的主题的名字一致

乱码问题

如果是记事本编辑后出现了乱码，尝试使用另存为更换编码方式为 utf-8

git错误:unable to auto-detect email address

每次重新新建工程时候git的配置信息都不能直接在命令行里修改 用户名 和邮箱，不会生效，且报错

*** Please tell me who you are.
Run
git config --global user.email "you@example.com"
git config --global user.name “Your Name”
to set your account’s default identity.
Omit --global to set the identity only in this repository.
fatal: unable to auto-detect email address (got ‘Administrator@PC-20150120BUBR.(none)’)

解决方案：
找到工程目录 (Project) 的.git文件夹 Hexo\.deploy_git\.git，打开之后找到 config 文件，在最后边加上一句话
[user]
email=your email
name=your name