.nuxtrc

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

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

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

使用

.nuxtrc
# Disable SSR
ssr=false

# Configuration for `@nuxt/devtools`
devtools.enabled=true

# Add Nuxt modules
modules[]=@nuxt/image
modules[]=nuxt-security

# Module setups (automatically added by Nuxt)
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 的优先级高于上述两者。