SKILL.md
唯讀
名稱
uni-app
描述
uni-app 跨平台開發框架的全面技能參考指南
本技能基於 uni-app 官方文件建立,生成時間為 2026-01-30。
uni-app 是一個基於 Vue.js 的跨平台開發框架,可用於開發執行在 iOS、Android、HarmonyOS、Web(響應式)以及各種小程式平台(微信/支付寶/百度/抖音/飛書/QQ/快手/釘釘/淘寶/京東/小紅書)的應用程式。
核心(Core)
| 主題 | 說明 | 參考文件 |
|---|---|---|
| 核心框架 | 專案結構、平台支援、條件編譯 | core-framework |
| 檢視元件 | view, scroll-view, swiper, movable-area, cover-view | core-view-components |
| 表單元件 | input, textarea, picker, checkbox, radio, switch, slider | core-form-components |
功能特性(Features)
UI 元件
| 主題 | 說明 | 參考文件 |
|---|---|---|
| 媒體元件 | image, video, camera, live-player, map | feature-media-components |
| 導覽 | navigator、路由、頁面導覽 | feature-navigation |
| UI 反饋 | toast、modal、loading、action sheet、下拉刷新 | feature-ui-feedback |
API
| 主題 | 說明 | 參考文件 |
|---|---|---|
| 網路 | HTTP 請求、檔案上傳/下載、WebSocket | feature-network |
| 儲存 | 本地儲存、檔案系統、快取 | feature-storage |
| 系統資訊 | 裝置資訊、網路狀態、螢幕、震動 | feature-system-info |
| 檔案操作 | 圖片/影片選擇、檔案系統操作 | feature-file-operations |
| 定位 | 地理定位、地圖元件、地址選擇 | feature-location |
| 生命週期 | App 與頁面的生命週期 Hook | feature-lifecycle |
設定(Configuration)
| 主題 | 說明 | 參考文件 |
|---|---|---|
| pages.json | 頁面路由、tab bar、全域樣式、分包設定 | config-pages |
| manifest.json | App 設定、權限設定、平台相關設定 | config-manifest |
平台支援(Platform Support)
| 平台 | 支援程度 |
|---|---|
| iOS App | 完整支援 |
| Android App | 完整支援 |
| HarmonyOS Next | 完整支援 |
| H5/Web | 完整支援 |
| 微信小程式 | 完整支援 |
| 支付寶小程式 | 完整支援 |
| 百度智慧小程式 | 完整支援 |
| 抖音小程式 | 完整支援 |
| QQ 小程式 | 完整支援 |
| 快手小程式 | 完整支援 |
| 飛書小程式 | 完整支援 |
| 京東小程式 | 完整支援 |
| 鴻蒙原子化服務 (Meta Service) | 完整支援 |
重要概念(Key Concepts)
條件編譯
使用特殊的註解語法撰寫特定平台的程式碼:
<!-- #ifdef APP-PLUS -->
<view>僅限 App</view>
<!-- #endif -->
<!-- #ifdef MP-WEIXIN -->
<view>僅限微信</view>
<!-- #endif -->
API Promise 支援
當未傳入 callback 時,大部分 uni-app API 都支援 Promise 呼叫方式:
const res = await uni.request({ url: 'https://api.example.com' })
跨平台最佳實踐
- 優先使用 uni-app 內建元件與 API,避免使用特定平台的專屬寫法
- 使用條件編譯處理平台專屬功能
- 在所有目標平台上進行測試
- 使用 rpx 進行響應式版面配置
- 在 manifest.json 中處理各平台的差異設定






