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

# Forwarding arguments to create-hono (npm requires `--`)
npm create hono@latest my-app -- --template cloudflare-workers

yarn

# "--template cloudflare-workers" selects the Cloudflare Workers template
yarn create hono my-app --template cloudflare-workers

pnpm

# "--template cloudflare-workers" selects the Cloudflare Workers template
pnpm create hono@latest my-app --template cloudflare-workers

bun

# "--template cloudflare-workers" selects the Cloudflare Workers template
bun create hono@latest my-app --template cloudflare-workers

deno

# "--template cloudflare-workers" selects the Cloudflare Workers template
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