---
title: ".nuxtrc"
description: ".nuxtrc 文件允许你以扁平语法定义 Nuxt 配置。"
canonical_url: "https://nuxt.zhcndoc.com/docs/4.x/directory-structure/nuxtrc"
---
# .nuxtrc

> .nuxtrc 文件允许你以扁平语法定义 Nuxt 配置。

`.nuxtrc` 文件可用于以扁平语法配置 Nuxt。它基于 [`unjs/rc9`](https://github.com/unjs/rc9)。

::tip
对于更高级的配置，请使用 [`nuxt.config`](https://nuxt.zhcndoc.com/docs/4.x/directory-structure/nuxt-config)。
::

## 用法

```bash [.nuxtrc]
# 禁用 SSR
ssr=false

# `@nuxt/devtools` 的配置
devtools.enabled=true

# 添加 Nuxt 模块
modules[]=@nuxt/image
modules[]=nuxt-security

# Module setups (automatically added by Nuxt)
setups.@nuxt/test-utils="3.23.0"
```

如果存在，`nuxt.config` 文件中的属性将覆盖 `.nuxtrc` 文件中的属性。

::note
Nuxt 会自动添加一个 `setups` 部分，以跟踪模块的安装和升级状态。这会在内部用于[模块生命周期钩子](https://nuxt.zhcndoc.com/docs/4.x/api/kit/modules#definenuxtmodule-example-using-lifecycle-hooks-for-module-installation-and-upgrade)，不应手动修改。
::

::read-more{to="https://nuxt.zhcndoc.com/docs/4.x/api/nuxt-config"}
在 **Nuxt 配置**文档中了解所有可用选项。
::

## 全局 `.nuxtrc` 文件

你也可以在主目录中创建一个全局 `.nuxtrc` 文件，以在全局应用配置。

- 在 macOS/Linux 上，此文件位于：
  ```md
  ~/.nuxtrc
  ```
- 在 Windows 上，位于：
  ```md
  C:\Users\{username}\.nuxtrc
  ```

此全局 `.nuxtrc` 文件允许你为系统上的所有 Nuxt 项目定义默认设置。然而，项目级别的 `.nuxtrc` 文件会覆盖这些全局设置，且 `nuxt.config` 将优先于两者。


## Sitemap

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