## Flutter 開發常見問題排查與解決
### 1. 項目初始化與依賴問題
```bash
# 清理項目
flutter clean
# 獲取依賴
flutter pub get
# 詳細日志運行
flutter run -v
```
### 2. 網絡和下載問題
- 網絡慢可能導致依賴下載卡住
- 使用 `-v` 參數可查看詳細日志
- 檢查網絡連接
- 可以嘗試使用國內鏡像源
### 3. Android 設備認證與配置
#### 設備連接前準備
1. 確保安裝 Android SDK Command-line Tools
2. 開啟開發者模式
3. 允許USB調試
### 4. 系統狀態檢查
```bash
# 檢查Flutter開發環境狀態
flutter doctor
```
### 5. Gradle 配置優化
#### build.gradle 配置
```gradle
// 調整最小SDK版本
defaultConfig {
? ? minSdkVersion 34 ?// 根據實際設備調整
? ? targetSdkVersion 35
}
```
#### gradle-wrapper.properties 修改
```properties
# 修改下載鏈接為 bin 版本
distributionUrl=https\://services.gradle.org/distributions/gradle-8.10.2-bin.zip
```
### 6. 常見卡住情況處理
- 網絡問題：檢查代理、切換網絡
- 依賴下載：使用 `flutter pub get --verbose`
- 編譯卡住：查看詳細日志 `flutter run -v`
### 7. 網絡加速建議
- 使用國內鏡像
- 配置 pub 源
```bash
# 配置國內鏡像
flutter pub config proxy=http://your-proxy-server
```
### 8. 設備連接troubleshooting
- 確保USB調試已開啟
- 檢查驅動程序
- 嘗試更換USB接口
- 重啟ADB服務 `adb kill-server && adb start-server`
### 9. 常用調試命令
```bash
# 列出可用設備
flutter devices
# 查看詳細診斷信息
flutter doctor -v
```
### 10. 最佳實踐
- 定期更新Flutter和Dart SDK
- 保持Gradle和依賴版本兼容
- 使用穩定的網絡環境
- 備份項目依賴配置
## 溫馨提示
- 遇到問題先看日志
- 不要盲目嘗試，逐步排查
- 必要時可以清理緩存重新開始
?
)
)
