---
title: "nuxt build-module"
description: "在发布前构建 Nuxt 模块的 Nuxt 命令。"
canonical_url: "https://nuxt.zhcndoc.com/docs/4.x/api/commands/build-module"
---
# nuxt build-module

> 在发布前构建 Nuxt 模块的 Nuxt 命令。

<!--build-module-cmd-->

```bash [Terminal]
npx nuxt build-module [ROOTDIR] [--cwd=<directory>] [--logLevel=<silent|info|verbose>] [--build] [--stub] [--sourcemap] [--prepare]
```

<!--/build-module-cmd-->

`build-module` 命令运行 `@nuxt/module-builder`，在你的 `rootDir` 中生成 `dist` 目录，其中包含 **nuxt-module** 的完整构建产物。

## 参数

<!--build-module-args-->

| 参数            | 描述             |
| ------------- | -------------- |
| `ROOTDIR="."` | 指定工作目录（默认：`.`） |

<!--/build-module-args-->

## 选项

<!--build-module-opts-->

| 选项                                   | 默认值     | 描述                            |
| ------------------------------------ | ------- | ----------------------------- |
| `--cwd=<directory>`                  |         | 指定工作目录，该选项优先于 ROOTDIR（默认：`.`） |
| `--logLevel=<silent\|info\|verbose>` |         | 指定构建时的日志级别                    |
| `--build`                            | `false` | 构建用于分发的模块                     |
| `--stub`                             | `false` | 在开发过程中生成 dist 存根，而不实际构建它      |
| `--sourcemap`                        | `false` | 生成 sourcemap                  |
| `--prepare`                          | `false` | 为本地开发准备模块                     |

<!--/build-module-opts-->

::read-more{to="https://github.com/nuxt/module-builder" icon="i-simple-icons-github" target="\_blank"}
详细了解 `@nuxt/module-builder`。
::

---

- [来源](https://github.com/nuxt/module-builder/blob/main/src/cli.ts)


## Sitemap

See the full [sitemap](https://nuxt.zhcndoc.com/sitemap.md) for all pages.