Create-hono

以下是 create-hono 支持的命令行选项。这个项目初始化工具会在你执行 npm create hono@latest、npx create-hono@latest 或 pnpm create hono@latest 时运行。

NOTE

为什么需要这篇文档？ 安装与快速上手示例通常只展示最精简的 npm create hono@latest my-app 命令。其实 create-hono 提供了很多实用的参数，可以帮助你自动化并自定义项目创建过程（选择模板、跳过交互式提示、指定包管理器、使用本地缓存等）。

传递参数

使用 npm create（或 npx）时，传给初始化脚本的参数必须放在 -- 之后。-- 后面的所有内容都会转发给初始化器。

npm

# 将参数转发给 create-hono（npm 必须使用 `--`）
npm create hono@latest my-app -- --template cloudflare-workers

yarn

# "--template cloudflare-workers" 会选择 Cloudflare Workers 模板
yarn create hono my-app --template cloudflare-workers

pnpm

# "--template cloudflare-workers" 会选择 Cloudflare Workers 模板
pnpm create hono@latest my-app --template cloudflare-workers

bun

# "--template cloudflare-workers" 会选择 Cloudflare Workers 模板
bun create hono@latest my-app --template cloudflare-workers

deno

# "--template cloudflare-workers" 会选择 Cloudflare Workers 模板
deno init --npm hono@latest my-app --template cloudflare-workers

常用参数

参数	说明	示例
--template <template>	选择一个起始模板，并跳过交互式模板提示。模板名称可能包括 bun、cloudflare-workers、vercel 等	--template cloudflare-workers
--install	模板创建完毕后自动安装依赖。	--install
--pm <packageManager>	指定安装依赖时使用的包管理器。常见值：npm、pnpm、yarn。	--pm pnpm
--offline	使用本地缓存／模板，而不是获取最新的远程模板。适合离线环境或希望固定模板版本的场景。	--offline

NOTE

模板列表与可用选项由 create-hono 项目维护。本文仅汇总了最常用的参数——完整且权威的参考请查看下方仓库链接。

示例流程

最小化、交互式

npm create hono@latest my-app

命令会提示你选择模板和其他选项。

非交互式：指定模板与包管理器

npm create hono@latest my-app -- --template vercel --pm npm --install

该命令会基于 vercel 模板创建 my-app，使用 npm 安装依赖，并跳过所有交互式提问。

使用离线缓存（无网络）

pnpm create hono@latest my-app --template deno --offline

故障排查与提示

• 如果某个参数似乎没有生效，请确认在使用 npm create／npx 时是否加上了 -- 进行转发。
• 想查看最新的模板与参数列表，可以直接查阅 create-hono 仓库，或者本地运行初始化工具并查看其帮助信息。

相关链接

• create-hono 仓库：create-hono