title: 使用 nuxi build 命令構建你的 Nuxt 應用程式
date: 2024/8/30
updated: 2024/8/30
author: cmdragon
excerpt:
nuxi build 命令是構建 Nuxt 應用程式的核心工具，它將你的應用程式打包成適合生產環境的格式。透過理解和使用不同的選項，如 --prerender、--dotenv 和 --log-level，你可以更好地控制構建過程，併為生產環境做好充分準備。
categories:
- 前端開發
tags:
- Nuxt
- 構建
- 生產
- 部署
- 預渲染
- 環境變數
- 日誌
掃描二維碼關注或者微信搜一搜：程式設計智域 前端至全棧交流與成長
在 Nuxt.js 開發過程中，將應用程式構建為生產環境的可部署版本是關鍵的一步。nuxi build 命令提供了一種方便的方式來完成這個任務。
什麼是 nuxi build？
nuxi build 命令用於將 Nuxt 應用程式構建成一個適合生產環境的版本。它會生成一個名為 .output 的目錄，其中包含你的應用程式程式碼、伺服器端程式碼和所有依賴項。這個目錄準備好用於生產環境部署。
基本用法
npx nuxi build [--prerender] [--dotenv] [--log-level] [rootDir]
引數說明
- rootDir：要打包的應用程式根目錄，預設為當前目錄 (
.)。如果你的應用程式位於不同的目錄，可以指定其他路徑。 - --prerender：預渲染應用程式的每個路由。注意：這是一個實驗性功能，可能會有變化。
- --dotenv：指定一個
.env檔案的路徑，環境變數將從這個檔案中讀取，路徑相對於根目錄。 - --log-level：設定日誌級別，以控制構建過程中的日誌輸出詳細程度。
如何使用 nuxi build 命令
1. 確保你已經安裝了 Nuxt
首先，確保你已經安裝了 Nuxt.js，並且專案已經建立並配置好。如果還沒有建立專案，你可以使用以下命令建立一個新的 Nuxt 專案：
npx nuxi@latest init my-nuxt-app
cd my-nuxt-app
2. 準備構建環境
在執行 nuxi build 命令之前，確保你的應用在開發模式下可以正常執行。你可以透過以下命令啟動開發伺服器進行測試：
npm run dev
3. 執行 nuxi build 命令
在你的專案目錄中，執行以下命令來構建你的應用：
npx nuxi build
這個命令會生成 .output 目錄，其中包含了構建後的檔案和資源。構建過程結束後，你可以將 .output 目錄部署到生產環境。
4. 使用構建選項
使用 --prerender 選項
如果你希望預渲染應用程式的每個路由（即在構建時生成靜態 HTML 檔案），可以使用 --prerender 選項：
npx nuxi build --prerender
這個選項會使 nuxi build 在構建時生成每個路由的靜態頁面，這在構建靜態站點時非常有用。
使用 --dotenv 選項
如果你需要從特定的 .env 檔案中載入環境變數，可以使用 --dotenv 選項。假設你的 .env 檔案位於專案根目錄下的 config 資料夾中，命令如下：
npx nuxi build --dotenv config/.env
這將使 Nuxt 從指定的 .env 檔案中讀取環境變數。
設定日誌級別
你還可以設定日誌級別以控制構建過程中的日誌輸出。透過 --log-level 選項可以指定不同的日誌詳細程度，例如：
npx nuxi build --log-level verbose
這將輸出更詳細的構建日誌，有助於除錯和了解構建過程。
示例
假設你已經建立了一個名為 my-nuxt-app 的 Nuxt 專案，並且希望構建這個應用。以下是如何使用 nuxi build 命令的示例：
- 基本構建：
npx nuxi build
- 預渲染所有路由：
npx nuxi build --prerender
- 使用特定的
.env檔案：
npx nuxi build --dotenv config/.env
- 設定詳細日誌輸出：
npx nuxi build --log-level verbose
總結
nuxi build 命令是構建 Nuxt 應用程式的核心工具，它將你的應用程式打包成適合生產環境的格式。透過理解和使用不同的選項，如 --prerender、--dotenv 和 --log-level，你可以更好地控制構建過程，併為生產環境做好充分準備。希望本文的示例和解釋能夠幫助你順利構建和部署你的 Nuxt 應用程式。
餘下文章內容請點選跳轉至 個人部落格頁面 或者 掃碼關注或者微信搜一搜：程式設計智域 前端至全棧交流與成長，閱讀完整的文章：使用 nuxi build 命令構建你的 Nuxt 應用程式 | cmdragon's Blog
往期文章歸檔：
- 使用 nuxi analyze 命令分析 Nuxt 應用的生產包 | cmdragon's Blog
- 使用 nuxi add 快速建立 Nuxt 應用元件 | cmdragon's Blog
- 使用 updateAppConfig 更新 Nuxt 應用配置 | cmdragon's Blog
- 使用 Nuxt 的 showError 顯示全屏錯誤頁面 | cmdragon's Blog
- 使用 setResponseStatus 函式設定響應狀態碼 | cmdragon's Blog
- 如何在 Nuxt 中動態設定頁面佈局 | cmdragon's Blog
- 使用 reloadNuxtApp 強制重新整理 Nuxt 應用 | cmdragon's Blog
- 使用 refreshNuxtData 重新整理 Nuxt應用 中的資料 | cmdragon's Blog
- 使用 prerenderRoutes 進行預渲染路由 | cmdragon's Blog
- 使用 preloadRouteComponents 提升 Nuxt 應用的效能 | cmdragon's Blog
- 使用 preloadComponents 進行元件預載入 | cmdragon's Blog
- 使用 prefetchComponents 進行元件預取 | cmdragon's Blog
- 使用 onNuxtReady 進行非同步初始化 | cmdragon's Blog
- 使用 onBeforeRouteUpdate 組合式函式提升應用的使用者體驗 | cmdragon's Blog
- 使用 onBeforeRouteLeave 組合式函式提升應用的使用者體驗 | cmdragon's Blog
- 使用 navigateTo 實現靈活的路由導航 | cmdragon's Blog
- 使用 Nuxt 3 的 defineRouteRules 進行頁面級別的混合渲染 | cmdragon's Blog
- 掌握 Nuxt 3 的頁面後設資料：使用 definePageMeta 進行自定義配置 | cmdragon's Blog
- 使用 defineNuxtRouteMiddleware 建立路由中介軟體 | cmdragon's Blog
- 使用 defineNuxtComponent`定義 Vue 元件 | cmdragon's Blog