Nuxt 3 已于 31 July 2026 结束生命周期
此版本将不再接收错误修复或安全补丁。 升级到 Nuxt 4 或获取 HeroDevs 提供的延长支持

.nuxtrc

.nuxtrc 文件允许您使用扁平语法定义 Nuxt 配置。

Maschinelle Übersetzung ·0 % geprüft

.nuxtrc 文件可用于以扁平语法配置 Nuxt。它基于 unjs/rc9。

如需更高级的配置，请使用 nuxt.config。

用法

.nuxtrc
# 禁用 SSR
ssr=false

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

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

# Modul-Setups (automatisch von Nuxt hinzugefügt)
setups.@nuxt/test-utils="3.23.0"

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

Nuxt 会自动添加一个 setups 部分，用于跟踪模块的安装和升级状态。此部分由内部的模块生命周期钩子使用，不应手动修改。
在 Nuxt 配置文档中了解所有可用选项。

全局 .nuxtrc 文件

您也可以在主目录中创建全局 .nuxtrc 文件，以实现全局配置的应用。

  • 在 macOS/Linux 系统上，此文件位于：

    ~/.nuxtrc

  • 在 Windows 上，它位于：

    C:\Users\{username}\.nuxtrc

此全局 .nuxtrc 文件允许您定义适用于系统中所有 Nuxt 项目的默认设置。但项目级别的 .nuxtrc 文件会覆盖这些全局设置，而 nuxt.config 会优先于两者。