UniApp 是一個基于 Vue.js 的跨平臺開發框架，支持快速構建小程序、H5、App 等應用。作為開發的第一步，正確安裝和配置 HBuilderX（官方推薦的 IDE）是至關重要的。下面我將以清晰步驟引導您完成整個過程，確保環境可用。整個過程基于 Windows 系統（其他系統類似），請確保網絡連接穩定。
步驟 1：下載 HBuilderX
- 訪問官網：打開瀏覽器，進入 HBuilderX 官方網站：https://www.dcloud.io/hbuilderx.html。
- 選擇版本：根據您的操作系統（Windows、Mac 或 Linux）下載對應安裝包。推薦下載標準版（包含基礎功能）。
- 下載完成：保存到本地文件夾，如
C:\Downloads。
步驟 2：安裝 HBuilderX
- Windows 系統：
- 解壓下載的 ZIP 文件（例如
HBuilderX.zip）到指定目錄，如C:\HBuilderX。 - 雙擊
HBuilderX.exe啟動 IDE（首次運行可能需管理員權限）。
- 解壓下載的 ZIP 文件（例如
- Mac/Linux 系統：
- 解壓 DMG/TAR 文件，拖拽應用圖標到應用程序文件夾。
- 啟動 HBuilderX，同意用戶協議。
- 驗證安裝：打開 HBuilderX 后，界面應顯示歡迎頁。如果報錯（如缺少依賴），請重啟電腦或檢查防火墻設置。
步驟 3：安裝 Node.js（環境依賴）
UniApp 依賴 Node.js 運行腳本和包管理，需先安裝：
- 下載 Node.js：
- 訪問 Node.js 官網：https://nodejs.org/。
- 下載 LTS 版本（如 v18.x），運行安裝程序。
- 安裝過程：
- 勾選 "Add to PATH" 選項，確保全局可用。
- 完成安裝后，打開命令提示符（CMD）或終端，輸入以下命令驗證：
node -v # 應輸出版本號，如 v18.17.1 npm -v # 應輸出 npm 版本，如 9.6.7
- 常見問題：如果命令無效，檢查環境變量（Path 中添加 Node.js 安裝路徑）。
步驟 4：配置 HBuilderX 環境
- 啟動 HBuilderX：確保 IDE 已打開。
- 設置 Node.js 路徑：
- 點擊頂部菜單：工具 > 設置 > 運行配置。
- 在 "Node 路徑" 欄，輸入 Node.js 可執行文件路徑（如
C:\Program Files\nodejs\node.exe）。 - 保存設置。
- 安裝 UniApp 插件：
- 點擊菜單：工具 > 插件安裝。
- 搜索 "uni-app"，選擇官方插件并安裝。
- 重啟 HBuilderX 生效。
- 檢查配置：點擊菜單：運行 > 運行到瀏覽器，如果無錯誤提示，表示環境就緒。
步驟 5：創建并運行測試項目
- 新建 UniApp 項目：
- 點擊菜單：文件 > 新建 > 項目。
- 選擇 "uni-app" 模板，輸入項目名稱（如
myFirstApp），選擇保存路徑。 - 點擊創建。
- 運行項目：
- 在項目管理器中，右鍵項目名，選擇 "運行" > "運行到瀏覽器"。
- HBuilderX 將自動編譯，并在默認瀏覽器打開預覽頁面（顯示 "Hello UniApp"）。
- 驗證成功：如果瀏覽器顯示 UniApp 歡迎界面，表示安裝和配置成功。
常見問題與解決
- HBuilderX 啟動失敗：可能是解壓不完整，重新下載安裝包；或關閉殺毒軟件。
- Node.js 命令無效：檢查環境變量（Path 是否包含 Node.js 路徑），或重新安裝 Node.js。
- 運行報錯（如依賴缺失）：在項目目錄運行
npm install安裝依賴。 - 跨平臺問題：Mac/Linux 用戶需使用
sudo權限安裝 Node.js。
)
