用 Blowfish Tools CLI 一键创建 Hugo 项目并自动安装配置 Blowfish 主题

方案简介

Blowfish Tools 是官方提供的 CLI 脚手架工具，将 Node.js/npm、Git 和 Hugo 组合起来，帮助用户以最少的步骤开始使用 Blowfish 主题。它会自动创建新的 Hugo 项目、安装主题并设置主题配置文件，把 git submodule 手动安装流程中「初始化仓库、添加 submodule、手动复制配置文件」等繁琐步骤全部自动化。

该方案解决的问题是：新手在安装 Hugo 主题时容易在项目结构、配置文件位置上出错。通过交互式 CLI 引导，用户只需运行一条命令即可获得一个可运行的 Blowfish 站点。

适合人群：已安装 Node.js、Git 和 Hugo，希望快速搭建 Blowfish 站点的用户。

组成与分工

• blowfish-tools：官方 CLI 工具，负责创建 Hugo 项目、安装主题、生成配置文件，并提供交互式引导
• npm：用于全局安装 blowfish-tools CLI
• Node.js：CLI 运行环境
• Git：版本管理与主题拉取的基础依赖
• Hugo：静态站点生成器，CLI 为其创建项目并安装主题

前置要求

• 确保已安装 Node.js、Git 和 Hugo
• 在继续之前需要已创建一个新的 Hugo 项目（交互模式）；new 命令可一步完成创建

实施步骤

1. 全局安装 CLI 工具

使用 npm（或其他包管理器）全局安装：

shell
npm i -g blowfish-tools

2. 运行交互式引导

运行 blowfish-tools 启动交互式流程，它会引导你完成创建和配置的使用场景：

shell
blowfish-tools

3. （可选）一步创建新项目并安装主题

shell
blowfish-tools new mynewsite

查看 CLI 帮助可了解更多信息。

注意事项与常见问题

• 前置条件：必须已安装 Node.js、Git 和 Hugo
• 若发现问题，官方提供了 blowfish-tools 独立仓库用于反馈问题
• 除 npm 外也可使用其他包管理器安装

优缺点

• ✓ 一条命令完成建站+装主题
• ✓ 交互式引导配置
• ✕ 额外依赖 Node.js/npm 环境

出处

本方案挖掘自开源项目 nunocoracao/blowfish，方案内容与实施命令均来自其 README 原文。