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

工具/原料

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

安裝Hexo

1、利用 npm 命令即可安裝。在任意位置點擊鼠標右鍵，選擇Git Base。

2、輸入命令：

npm install -g hexo

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

創建Hexo文件夾

安裝完成后，在你喜愛的文件夾下（如C:\Hexo），執行以下指令(在C:\Hexo內點擊鼠標右鍵，選擇Git Bash)，Hexo 即會自動在目標文件夾建立網站所需要的所有文件。

hexo init

安裝依賴包

npm install

本地查看

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

hexo generate

hexo server

注冊Github賬號

這里不演示了。

創建Repository

創建的時候注意Repository的名字。比如我的Github賬號是angelen10，那么我應該創建的Repository的名字是：angelen10.github.io。

修改配置文件

1、到你剛剛創建的Repository下，找到以下內容：

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

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

設置SSH keys

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

1、在Git Bash輸入以下指令（任意位置點擊鼠標右鍵），檢查是否已經存在了SSH keys。

ls -al ~/.ssh

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

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

ssh-keygen -t rsa -C "[email protected]"

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

5、然后鍵入以下指令：

ssh-agent -s

6、繼續輸入指令：

ssh-add ~/.ssh/id_rsa

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

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

eval `ssh-agent -s`

ssh-add

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

clip < ~/.ssh/id_rsa.pub

10、然后到Github里面，點擊右上角的設置圖標：

11、在Settings sidebar那里，點擊SSH keys：

12、點擊Add SSH key：

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

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

15、點擊Add Key：

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

ssh -T [email protected]

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

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

“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.”

說是主機密鑰驗證失敗，其實這是缺少了 known_hosts 文件, 而且必須生成 github.com 的ip執行內容。

輸入：ssh [email protected]

然后看到：

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 目錄里將是三個文件，這樣再連的時候就沒事了。)

完成部署

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

hexo generate

hexo deploy

(有一些用戶在hexo deploy之后會有個這個提示：

那么我們要輸入我們在git上驗證的郵箱：

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

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

http://checkfrank.github.io/

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

對了，記住上圖的Username是你的Github賬號名稱，而不是郵箱；Password就是你的Github的密碼。

bugs

1.有網友反應右鍵菜單中沒有 git bash 選項，可以進入開始菜單找到 git bash ，然后通過 cd 進入相應目錄執行命令。

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

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

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

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

6.安裝 hexo 時卡在那兒不動，很可能是網絡不給力，能全局 break wall 就好了。

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

Tips

hexo現在支持更加簡單的命令格式了，比如：

hexo g == hexo generate

hexo d == hexo deploy

hexo s == hexo server

hexo n == hexo new

注意事項

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