---
title: ".nuxtignore"
description: ".nuxtignore 文件让 Nuxt 在构建阶段忽略项目根目录中的文件。"
canonical_url: "https://nuxt.zhcndoc.com/docs/4.x/directory-structure/nuxtignore"
---
# .nuxtignore

> .nuxtignore 文件让 Nuxt 在构建阶段忽略项目根目录中的文件。

`.nuxtignore` 文件会告知 Nuxt 在构建阶段忽略项目根目录（[`rootDir`](https://nuxt.zhcndoc.com/docs/4.x/api/nuxt-config#rootdir)）中的文件。

它遵循与 [`.gitignore`](https://nuxt.zhcndoc.com/docs/4.x/directory-structure/gitignore) 和 `.eslintignore` 文件相同的规范，其中每一行都是一个 glob 模式，用于指定要忽略的文件。

::tip
你也可以在 `nuxt.config` 文件中配置 [`ignoreOptions`](https://nuxt.zhcndoc.com/docs/4.x/api/nuxt-config#ignoreoptions)、[`ignorePrefix`](https://nuxt.zhcndoc.com/docs/4.x/api/nuxt-config#ignoreprefix) 和 [`ignore`](https://nuxt.zhcndoc.com/docs/4.x/api/nuxt-config#ignore)。
::

## 用法

```bash [.nuxtignore]
# 忽略布局 foo.vue
app/layouts/foo.vue
# 忽略名称以 -ignore.vue 结尾的布局文件
app/layouts/*-ignore.vue

# 忽略页面 bar.vue
app/pages/bar.vue
# 忽略 ignore 文件夹内的页面
app/pages/ignore/*.vue

# 忽略 foo 文件夹下的路由中间件文件，除了 foo/bar.js
app/middleware/foo/*.js
!app/middleware/foo/bar.js
```

::read-more
```yaml [props]
icon: i-simple-icons-git
title: git 文档
to: https://git-scm.com/docs/gitignore
target: _blank
```
关于该规范的更多细节，请参见 **gitignore 文档**。
::


## Sitemap

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