hexo常用指令

发表于 更新于 分类于 ， 阅读次数：

以下是 Hexo 常用的指令整理，方便快速查阅：

基础操作

  1. 初始化博客

    1
    hexo init [文件夹名]  # 创建新博客（不指定文件夹则在当前目录生成）

  2. 安装依赖

    1
    npm install           # 安装 Hexo 核心依赖（初始化后可能需要执行）

  3. 本地预览

    1
    hexo server           # 启动本地服务器（默认端口 4000），缩写：hexo s

  4. 生成静态文件

    1
    hexo generate         # 生成 public 文件夹的静态文件，缩写：hexo g

  5. 部署到服务器

    1
    hexo deploy           # 部署到 GitHub Pages 或其他平台，缩写：hexo d

文章与页面

  1. 新建文章

    1
    hexo new "文章标题"    # 生成新文章（Markdown 文件），缩写：hexo n

  2. 新建页面

    1
    hexo new page "页面名" # 创建自定义页面（如 about、tags）

清理与调试

  1. 清理缓存

    1
    hexo clean            # 删除生成的 public 和缓存文件（修改主题后建议执行）

  2. 查看帮助

    1
    hexo help             # 查看所有指令说明

组合指令（高效操作）

  • 生成并部署

    1
    2
    hexo g -d          # 先生成静态文件，再部署（等同 hexo generate && hexo deploy）
    hexo d -g          # 同上，顺序不影响结果

  • 生成并预览

    1
    hexo s -g          # 先生成文件，再启动本地服务器

注意事项

  • 部署前配置：需在 _config.yml 中设置 deploy 参数（如 GitHub 仓库地址）。
  • 安装部署插件：首次部署需运行 npm install hexo-deployer-git。
  • 主题安装：将主题克隆到 themes/ 文件夹后，在配置文件中指定主题名称。

如果需要更详细的操作说明，可以补充具体场景（如更换主题、设置分类等）！

hexo d上传失败，网络连接问题解决方案

原因：Clash 虽然开启了代理，但 Git 默认不会走这个代理，导致连接 GitHub 时失败

image-20250722204420664

解决方案：

查看端口号

image-20250722204512612

查看git代理

1
2
git config --global --get http.proxy
git config --global --get https.proxy

更改代理

1
2
git config --global http.proxy socks5://127.0.0.1:1080
git config --global https.proxy socks5://127.0.0.1:1080

参考教程

HEXO系列教程 | 使用GitHub部署静态博客HEXO | 小白向教程 – 夜梦星尘の折腾日记

Github王炸功能Pages,免费免服务器上线网站,详细教程_哔哩哔哩_bilibili