相較於功能強大、結構複雜的 nuxt.config.ts，.nuxtrc 就像一張便利貼，讓您可以用最簡單的語法，快速調整一些設定。

1. 什麼是 `.nuxtrc`？

它是一個設定檔，最大的特色就是語法非常簡單，採用 key=value 的扁平格式，就像我們在 .env 檔案中看到的那樣。

.nuxtrc

# .nuxtrc

# 禁用 SSR (Server-Side Rendering)
ssr=false

# 啟用開發者工具
devtools.enabled=true

# 新增模組 (用 [] 來表示陣列)
modules[]=@nuxt/image
modules[]=@nuxt/content

語法說明：

key=value→ 基本鍵值對設定

nested.key=value→ 巢狀物件設定

array[]=item→ 陣列項目設定

2. 設定的優先級

當您同時擁有多個設定檔時，Nuxt 採用「越詳細的設定，權力越大」的原則。優先級如下：

nuxt.config.ts>專案 .nuxtrc>全域 ~/.nuxtrc

讓我們用一個家庭規則的比喻來理解：

🌐

全域 ~/.nuxtrc (社區公告)

您可以電腦的用戶根目錄下建立一個 .nuxtrc 檔案。

這裡的設定對您電腦上所有的 Nuxt 專案都有效，就像社區的公告。

🏠

專案 .nuxtrc (家庭規則)

這是放在您專案根目錄的 .nuxtrc。

它的規則會覆蓋「社區公告」的規則。

📋

nuxt.config.ts (裝修藍圖)

這是您專案裡最詳細的設定檔，擁有最高的決定權，會覆蓋前面兩者的所有設定。

3. 使用時機

快速切換

當您只是想快速切換某個開關（例如 ssr=false）來進行測試，而不想去動複雜的 nuxt.config.ts 檔案時。

全域預設

如果您希望您電腦上所有新建立的 Nuxt 專案，預設都啟用某個模組或設定，就可以把它寫在全域的 ~/.nuxtrc 裡。

實際範例：

快速測試用的專案設定

# 快速切換為 SPA 模式進行測試
ssr=false

# 啟用開發者工具
devtools.enabled=true

# 暫時停用某個模組
modules[]=!@nuxt/image

今日總結

.nuxtrc 提供了一個用簡單語法快速配置 Nuxt 的方法，它就像是 nuxt.config.ts 的一個輕量級輔助工具。

採用簡單的 key=value 語法，易於理解和使用。

支援全域（~/.nuxtrc）和專案層級的設定。

優先級低於 nuxt.config.ts，適合快速測試和臨時調整。

特別適合設定個人開發環境的預設偏好。

最佳實踐

了解它和 nuxt.config.ts 之間的優先級關係，可以幫助您更好地管理您的專案設定，無論是針對單一專案還是您個人的開發環境。