nuxi 命令生成器
生成用于搭建、开发、构建和管理 Nuxt 3 项目的 nuxi 命令
nuxi 入门指南
## 什么是 nuxi?
`nuxi` 是 Nuxt 3+ 的命令行界面。它可用于创建新项目、运行开发服务器、构建生产版本、生成静态网站,以及执行升级 Nuxt 或分析包大小等维护任务。
## 使用方法
1. **选择操作**:`init`、`dev`、`build`、`generate`、`preview`、`upgrade`、`info`、`cleanup`、`analyze` 或 `typecheck`。 2. **设置目标**:对于 `init`,需输入项目目录名称。 3. **设置选项**:对于 `dev`,需设置端口(`-p`);对于 `--package-manager`,需指定要固定的 npm/pnpm/yarn/bun 版本。 4. **复制并运行**:大多数命令可在现有的 Nuxt 项目中运行;而 `init` 用于创建新项目。
常用操作与选项
### `init` 创建新项目 在新的目录中创建一个全新的 Nuxt 应用:`nuxi init my-app`。
### `dev` 开发服务器 在默认端口 3000 上启动热重载开发服务器。如需更改端口,请使用 `-p`:`nuxi dev -p 4000`。
### `build` / `generate` 生产环境输出 `build` 会生成用于服务器端渲染的 Node 服务器包(`.output/server`);而 `generate` 会将整个网站预渲染为静态 HTML 文件,存储在`.output/public`中,以便进行静态托管。
### `preview` 运行生产环境构建结果 在部署之前,可通过 `build` 或 `generate` 在本地运行`.output`生成的文件,对其进行验证。
### `upgrade` / `info` / `cleanup` `upgrade` 用于升级 Nuxt 版本;`info` 用于显示项目所处的环境及各版本信息;`cleanup` 用于清除构建缓存(`.nuxt`、`node_modules/.cache`)。
### `analyze` / `typecheck` `analyze` 用于构建项目并打开包分析工具;`typecheck` 用于运行`vue-tsc`,对整个项目进行类型检查。
### `--package-manager=NAME` 为`init`以及其他需要了解安装情况的命令锁定包管理器(npm、ppnm、yarn、bun)的版本。
▶build 还是 generate —— 我该用哪个?
▶如何在不同的端口上运行开发服务器?
▶如何使用 pnpm 而非 npm 来创建项目?
如果这个工具对你有帮助的话,请考虑请我喝杯咖啡。
请给我买杯咖啡吧。