Flutter 开发常见问题排查与解决
1. 项目初始化与依赖问题
```bash
清理项目
flutter clean
获取依赖
flutter pub get
详细日志运行
flutter run -v
```
2. 网络和下载问题
-
网络慢可能导致依赖下载卡住
-
使用 `-v` 参数可查看详细日志
-
检查网络连接
-
可以尝试使用国内镜像源
3. Android 设备认证与配置
设备连接前准备
-
确保安装 Android SDK Command-line Tools
-
开启开发者模式
-
允许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和依赖版本兼容
-
使用稳定的网络环境
-
备份项目依赖配置
温馨提示
-
遇到问题先看日志
-
不要盲目尝试，逐步排查
-
必要时可以清理缓存重新开始