[TOC] #### 1. 環境變量聲明規范 ---- 在 Vue3 項目中獲取 `.env` 文件中的配置項，需要遵守以下步驟和規范 變量前綴：使用 `VITE_` 作為自定義環境變量的前綴（Vite 默認要求），否則變量無法被客戶端訪問 ```ini # .env.development VITE_API_URL = http://localhost:3000/api ``` 文件命名規則： | 命名規則 | 描述 | | ------------ | ------------ | | .env | 全局默認配置，所有環境都會加載 | | .env.[model] | 按模式加載（如：.env.dev、.env.prod） | | .env.local | 本地覆蓋文件（優先級高于 .env，但會被 git 忽略） | #### 2. 在代碼中獲取環境變量 ---- 第一種方式：通過 `import.meta.env` 訪問 在 Vue 組件或 JS/TS 文件中直接使用，可以讀取到所有環境變量（僅 `VITE_` 前綴的變量可通過此方式獲?。? ```javascript const env = import.meta.env ``` 第二種方式：在 Vite 配置文件中使用 在 `vite.config.ts` 中通過 `loadEnv` 加載環境變量 特別注意：此方法支持讀取所有環境變量，包含非 `VITE_` 前綴的變量 ```javascript import { defineConfig, loadEnv } from 'vite'; export default defineConfig(({ mode }) => { const env = loadEnv(mode, process.cwd()); console.log(env.VITE_API_URL); // 輸出配置值 return { /* 其他配置 */ }; }); ``` #### 3. 運行模式和文件匹配 ---- 默認模式： + `npm run dev` 默認加載：`.env.development` + `npm run build` 默認加載：`.env.production` 自定義模式：通過 `--mode` 參數指定模式 ```json // package.json { "scripts": { // 此時會加載 .env.test 文件 "build:test": "vite build --mode test" } } ``` #### 4. 高級配置 ---- 自定義變量前綴：變量前綴默認是 `VITE_` 可以在 vite.config.ts 文件中修改 envPrefix，此時需在 .env 文件中聲明 `APP_` 前綴的變量 ```javascript export default defineConfig({ envPrefix: 'APP_' // 變量需以 APP_ 開頭 }); ``` 多環境文件優先級：同名變量優先級高的文件會覆蓋低優先級文件中的值 ``` .env.[mode].local > .env.[mode] > .env.local > .env ``` #### 5. 注意事項 ---- **一、敏感信息安全** 避免在客戶端暴露敏感信息（如數據庫密碼），`VITE_` 前綴的變量會被編譯到前端代碼中 **二、類型提示支持（此配置可避免 TypeScript 報錯）** 在 src 目錄下創建 env.d.ts 文件以增強 TypeScript 類型提示 ```typescript interface ImportMetaEnv { readonly VITE_API_URL: string; } ```