Windows下部署Hexo博客过程

本文最后更新于：30 分钟前

前言

本过程完全按照CodeSheep的视频（ https://www.bilibili.com/video/BV1Yb411a7ty ）操作，区别是在Windows环境下而非MacOS下部署。在此描述出所有步骤，以及踩过的一些坑。

一、前置环境搭建

Node.JS、npm安装

进入官网 https://nodejs.org 选择LTS(Long Term Support)版本执行全默认安装即可。

使用PowerShell（管理员模式）输入命令：
node -v
验证安装是否成功

cnpm安装

npm install -g cnpm --registry=http://registry.npm.taobao.org #安装淘宝源的 cnpm 管理器

两个坑

  • 安装cnpm提示"x packages are looking for funding."
    可选择忽略或install或使用
    npm install --no-fund -g cnpm --registry=http://registry.npm.taobao.org
    的方式跳过fund。[1]

  • 输入 cnpm -v 后提示"无法加载文件 C:*****.ps1，因为在此系统上禁止运行脚本"
    请使用命令
    set-ExecutionPolicy RemoteSigned
    允许在系统上运行脚本。[2]

二、Hexo框架安装与配置

Hexo框架安装

cnpm install -g hexo-cli

坑

  • 安装过程提示需要git
    https://git-scm.com/download/win 官方提供两种方式安装，这里使用PowerShell中的命令行安装，命令如下：
    winget install --id Git.Git -e --source winget
    重启PowerShell后即安装成功

  • Git报错： Failed to connect to github.com port 443 解决方案
    由于我手里有魔法，故根据CSDN上的教程[3]修改sock5和http代理即可

Hexo的配置

  • 选择一个目标位置创建Blog文件夹（这里选择C:）
    mkdir blog
    cd blog

  • 初始化
    hexo init #win环境下无需sudo，管理员模式启动即可

三、常用命令

  • 本地预览
    hexo server #或 hexo s 启动预览
    进入 http://localhost:4000/ 本地访问地址

  • hexo new "我的第一篇文章" #或 hexo n 创建新的文章

  • hexo clean #或 hexo c 清理

  • hexo generate #或 hexo g 生成

  • hexo deploy #或 hexo d部署到远端

四、部署到远端（以Github为例）

登录Github创建一个新的仓库

坑：
· 必须以 用户名.github.io的形式命名仓库
· 必须是public库而非private库，否则可能会遇到404问题

在Blog目录下安装git部署插件

cnpm install --save hexo-deployer-git #注意必须是Blog目录下，否则请删除Blog重来 ## 配置Blog目录下的 _config.yml 文件

1
2
3
4
5
6
   \# Deployment  
\## Docs: https://hexo.io/docs/deployment.html  
deploy:  
 		type: git  
		repo: https://github.com/YourGithubName/YourGithubName.github.io.git  
 		branch: master

部署到远端

hexo deploy #或hexo d ## 访问博客
https://YourGithubName.github.io.git即你的博客地址

五、更换博客皮肤（非必须，以Yilia为例）

  • git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia #下载yilia主题到本地

修改_config.yml配置文件

  • theme: landscape 改为 theme: yilia

清理、生成、部署、查看

  • hexo c #清理
  • hexo g #生成
  • hexo d #部署
  • 访问 https://YourGithubName.github.io.git #查看

Tips

  • 博文的具体内容在 /Blog/source/_posts/我的第一篇文章.md中修改
  • 推荐使用开源软件 VSCode + 插件MarkDown All in One查看修改.md文件

参考资料

[1] https://www.likecs.com/ask-545634.html
[2] https://zhuanlan.zhihu.com/p/617284262
[3] https://blog.csdn.net/zpf1813763637/article/details/128340109