---
title: "nuxt dev"
description: "dev 命令会在 http://localhost:3000 启动一个支持热模块替换的开发服务器"
canonical_url: "https://nuxt.zhcndoc.com/docs/3.x/api/commands/dev"
---
# nuxt dev

> dev 命令会在 http://localhost:3000 启动一个支持热模块替换的开发服务器

<!--dev-cmd-->

```bash [Terminal]
npx nuxt dev [ROOTDIR] [--cwd=<directory>] [--logLevel=<silent|info|verbose>] [--dotenv] [--envName] [-e, --extends=<layer-name>] [--clear] [--no-f, --no-fork] [-p, --port] [-h, --host] [--clipboard] [-o, --open] [--https] [--publicURL] [--qr] [--public] [--tunnel] [--profile[=verbose]] [--sslCert] [--sslKey]
```

<!--/dev-cmd-->

`dev` 命令会在 [http://localhost:3000](https://localhost:3000) 启动一个支持热模块替换的开发服务器

## 参数

<!--dev-args-->

| 参数               | 描述              |
| ---------------- | --------------- |
| `ROOTDIR="."`    | 指定工作目录（默认值：`.`） |
| <!--/dev-args--> |                 |

## 选项

<!--dev-opts-->

| 选项                                   | 默认值     | 描述                                                                                 |
| ------------------------------------ | ------- | ---------------------------------------------------------------------------------- |
| `--cwd=<directory>`                  |         | 指定工作目录，此选项优先于 ROOTDIR（默认值：`.`）                                                     |
| `--logLevel=<silent\|info\|verbose>` |         | 指定构建时日志级别                                                                          |
| `--dotenv`                           |         | 要加载的 `.env` 文件路径，相对于根目录                                                            |
| `--envName`                          |         | 解析配置覆盖时使用的环境（构建时默认为 `production`，运行开发服务器时默认为 `development`）                        |
| `-e, --extends=<layer-name>`         |         | 从 Nuxt layer 扩展                                                                    |
| `--clear`                            | `false` | 重启时清除控制台                                                                           |
| `--no-f, --no-fork`                  |         | 禁用 fork 模式                                                                         |
| `-p, --port`                         |         | 要监听的端口（默认值：`NUXT_PORT \|\| NITRO_PORT \|\| PORT \|\| nuxtOptions.devServer.port`）  |
| `-h, --host`                         |         | 要监听的主机（默认值：`NUXT_HOST \|\| NITRO_HOST \|\| HOST \|\| nuxtOptions.devServer?.host`） |
| `--clipboard`                        | `false` | 将 URL 复制到剪贴板                                                                       |
| `-o, --open`                         | `false` | 在浏览器中打开 URL                                                                        |
| `--https`                            |         | 启用 HTTPS                                                                           |
| `--publicURL`                        |         | 显示的公共 URL（用于二维码）                                                                   |
| `--qr`                               |         | 可用时显示公共 URL 的二维码                                                                   |
| `--public`                           |         | 监听所有网络接口                                                                           |
| `--tunnel`                           |         | 使用 <https://github.com/unjs/untun> 打开隧道                                            |
| `--profile[=verbose]`                |         | 分析性能。使用 `--profile` 仅分析 CPU，使用 `--profile=verbose` 获取完整报告                          |
| `--sslCert`                          |         | （已弃用）请改用 `--https.cert`                                                            |
| `--sslKey`                           |         | （已弃用）请改用 `--https.key`                                                             |
| <!--/dev-opts-->                     |         |                                                                                    |

还可以通过 NUXT_PORT、PORT、NUXT_HOST 或 HOST 环境变量设置端口和主机。

除了上述选项之外，`@nuxt/cli` 还可以将选项传递给 `listhen`，例如使用 `--no-qr` 关闭开发服务器二维码。你可以在 [unjs/listhen](https://github.com/unjs/listhen) 文档中找到 `listhen` 选项列表。

此命令会将 `process.env.NODE_ENV` 设置为 `development`

::note
如果你在开发环境中使用自签名证书，则需要在环境中设置 `NODE_TLS_REJECT_UNAUTHORIZED=0`
::

---

- [Source](https://github.com/nuxt/cli/blob/3.x/packages/nuxi/src/commands/dev.ts)


## Sitemap

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