03
Re:Nuxt 100 天練習曲
Day 3
指揮你的 Nuxt 專案
Day 3·設定檔·專案配置
昨天我們成功建立了專案,今天來認識一下專案的「大腦」和「名片」——也就是設定檔。
Nuxt 專案就像一輛新車,出廠設定就很棒了。但如果你想加裝導航、換個烤漆,就需要調整「設定」。今天我們就來認識最重要的兩個設定檔。
1. 專案的大腦:nuxt.config.ts
這是 Nuxt 最核心、最強大的設定檔,位於你專案的根目錄。
你可以把它想像成汽車的行車電腦。未來我們要安裝新功能 (Modules)、連接後端、調整 SEO、或是進行各種效能優化,都會來這裡修改。
nuxt.config.ts
// nuxt.config.ts
export default defineNuxtConfig({
// 未來大部分的設定都會寫在這裡
})
特別注意:這個檔案裡有一個重要的區域叫做 runtimeConfig
,專門用來放一些需要保密或可能變動的資訊,例如 API 金鑰。放在這裡的資料比較安全,不會直接暴露在網頁原始碼中。
2. 專案的名片:app.config.ts
這個檔案相對單純,你可以把它看作是應用程式的公開名片。
它用來存放那些不需要保密、而且是公開給所有人看的設定。例如:
網站標題
佈景主題(深色/淺色模式)
社群媒體連結
app.config.ts
// app.config.ts
export default defineAppConfig({
title: '我的練習曲網站',
theme: {
dark: true,
}
})
今日總結:該用哪一個?
記住這個簡單的原則就好:
需要保密、跟功能有關的 → 放在 nuxt.config.ts
(大腦)
公開的、跟外觀/資訊有關的 → 放在 app.config.ts
(名片)
今天我們只需要知道有這兩個檔案,以及它們大概的用途。未來當我們需要客製化專案時,就知道該去哪裡找了。不用急著記住所有細節,實際用到時自然就會明白!