搭建hexo部署到github圖文教程 親測(cè)可用超詳細(xì)

很多網(wǎng)友想搭建Hexo博客并部署到Github，但是總是遇到各種問題，那么下面小編就帶來這“史上最詳細(xì)“截圖”搭建Hexo博客并部署到Github”教程吧。

工具/原料

Windows（Mac也是差不多，可參照）、Git、Node.js。

安裝Hexo

1、利用 npm 命令即可安裝。在任意位置點(diǎn)擊鼠標(biāo)右鍵，選擇Git Base。

2、輸入命令：

npm install -g hexo

注意：-g是指全局安裝hexo。

創(chuàng)建Hexo文件夾

安裝完成后，在你喜愛的文件夾下（如C:\Hexo），執(zhí)行以下指令(在C:\Hexo內(nèi)點(diǎn)擊鼠標(biāo)右鍵，選擇Git Bash)，Hexo 即會(huì)自動(dòng)在目標(biāo)文件夾建立網(wǎng)站所需要的所有文件。

hexo init

安裝依賴包

npm install

本地查看

現(xiàn)在我們已經(jīng)搭建起本地的hexo博客了，執(zhí)行以下命令(在C:\Hexo)，然后到瀏覽器輸入localhost:4000看看。

hexo generate

hexo server

注冊(cè)Github賬號(hào)

這里不演示了。

創(chuàng)建Repository

創(chuàng)建的時(shí)候注意Repository的名字。比如我的Github賬號(hào)是angelen10，那么我應(yīng)該創(chuàng)建的Repository的名字是：angelen10.github.io。

修改配置文件

1、到你剛剛創(chuàng)建的Repository下，找到以下內(nèi)容：

2、先點(diǎn)擊HTTPS，然后復(fù)制里面的地址。然后編輯_config.yml文件（在C:\Hexo下）。

3、修改文件里面的deploy。其中的repository就改成你剛剛復(fù)制的地址。保存這個(gè)文件。

設(shè)置SSH keys

配置SSH的官方教程是：https://help.github.com/articles/generating-ssh-keys/

1、在Git Bash輸入以下指令（任意位置點(diǎn)擊鼠標(biāo)右鍵），檢查是否已經(jīng)存在了SSH keys。

ls -al ~/.ssh

2、如果不存在就沒有關(guān)系，如果存在的話，直接刪除.ssh文件夾里面所有文件：

3、輸入以下指令（郵箱就是你注冊(cè)Github時(shí)候的郵箱）后，回車：

ssh-keygen -t rsa -C "angelen10@163.com"

4、然后它會(huì)提示要你輸入passphrase（如上圖，我沒有輸入直接回車，如果你輸入的話，要記得，到時(shí)候會(huì)用到）。之后，如果出現(xiàn)類似下圖：

5、然后鍵入以下指令：

ssh-agent -s

6、繼續(xù)輸入指令：

ssh-add ~/.ssh/id_rsa

7、輸入之后，在我這里是出錯(cuò)了，不知道你的有沒有出錯(cuò)。

8、如果你的也是這樣子出錯(cuò)了的話，就輸入以下指令：

eval `ssh-agent -s`

ssh-add

9、到了這一步，就可以添加SSH key到你的Github賬戶了。鍵入以下指令，拷貝Key（先拷貝了，等一下可以直接粘貼）：

clip < ~/.ssh/id_rsa.pub

10、然后到Github里面，點(diǎn)擊右上角的設(shè)置圖標(biāo)：

11、在Settings sidebar那里，點(diǎn)擊SSH keys：

12、點(diǎn)擊Add SSH key：

13、輸入Title，作為這個(gè)key的描述吧（你可以輸入Personal MacBook Air，瞬間高大上）

14、然后這個(gè)Key就是剛剛拷貝的，你直接粘貼就好（也可以文本打開以下文件）：

15、點(diǎn)擊Add Key：

16、輸入你的Github密碼即可完成SSH Key的添加。嗯，最后還是測(cè)試一下吧，鍵入以下命令：

ssh -T git@github.com

17、你可能會(huì)看到有警告，沒事，輸入“yes”就好。

(一般在添加完公鑰之后, 很多人經(jīng)常會(huì)遇到下面這種問題：

“The authenticity of host 'github.com (192.30.252.128)' can't be established.
RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
Are you sure you want to continue connecting (yes/no)?
**Host key verification failed.**
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.”

說是主機(jī)密鑰驗(yàn)證失敗，其實(shí)這是缺少了 known_hosts 文件, 而且必須生成 github.com 的ip執(zhí)行內(nèi)容。

輸入：ssh git@github.com

然后看到：

The authenticity of host 'github.com (192.30.252.131)' can't be established.
RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
Are you sure you want to continue connecting (yes/no)? yes    #這里寫 yes
Warning: Permanently added 'github.com,192.30.252.131' (RSA) to the list of known hosts.
Permission denied (publickey)。

然后 .ssh 目錄里將是三個(gè)文件，這樣再連的時(shí)候就沒事了。)

完成部署

最后一步，快要成功了，鍵入指令：

hexo generate

hexo deploy

(有一些用戶在hexo deploy之后會(huì)有個(gè)這個(gè)提示：

那么我們要輸入我們?cè)趃it上驗(yàn)證的郵箱：

如上圖！再次hexo deploy，就發(fā)布上去了。）

OK，我們的博客就已經(jīng)完全搭建起來了，在瀏覽器輸入（你的用戶名，下面是我的演示）：

http://checkfrank.github.io/

注意：每次修改本地文件后，需要鍵入hexo generate才能保存。每次使用命令時(shí)，都要在C:\Hexo目錄下。每次想要上傳文件到Github時(shí)，就應(yīng)該先鍵入hexo generate保存之后，再鍵入hexo deploy。大概成功之后是醬紫的：

對(duì)了，記住上圖的Username是你的Github賬號(hào)名稱，而不是郵箱；Password就是你的Github的密碼。

bugs

1.有網(wǎng)友反應(yīng)右鍵菜單中沒有 git bash 選項(xiàng)，可以進(jìn)入開始菜單找到 git bash ，然后通過 cd 進(jìn)入相應(yīng)目錄執(zhí)行命令。

2.在github部署完成之后，馬上訪問可能出現(xiàn)404錯(cuò)誤，這是正常的，（最多）等待十分鐘左右就可以訪問了。如果還不行，那很可能是 github 發(fā)送給你的驗(yàn)證郵件你沒有打開看，據(jù)多方反映，驗(yàn)證后就沒問題了。

3.如果在 hexo d 之后出現(xiàn) fatal: 'username.github.io' does not appear to be a git repository ，一是檢查 repo 的名字是否合乎規(guī)范、是否含有大寫字母、config.yml 中的 deploy 配置是否正確，二是把 git bash 關(guān)掉，重新打開再執(zhí)行命令。

4.有的同學(xué)可能不是 IT 界的，或者對(duì)shell 命令不太了解。在要求輸入密碼時(shí)，你輸入之后密碼是不顯示的，這是為了安全，并非是你沒輸上。

5.出現(xiàn)亂碼的，不要使用 windows 中的「記事本」打開并編輯文件，推薦使用 sublime text，很簡(jiǎn)單。如果已經(jīng)在「記事本」中編輯過，需要使用 sublime text 轉(zhuǎn)碼為「utf8」。

6.安裝 hexo 時(shí)卡在那兒不動(dòng)，很可能是網(wǎng)絡(luò)不給力，能全局 break wall 就好了。

7.遇到什么其他的問題，不妨刪除.deploy 和db.json 再重新生成試一試。

Tips

hexo現(xiàn)在支持更加簡(jiǎn)單的命令格式了，比如：

hexo g == hexo generate

hexo d == hexo deploy

hexo s == hexo server

hexo n == hexo new

注意事項(xiàng)

這篇和官方的說法有一點(diǎn)不一樣，不過這是成功之談。