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和依赖版本兼容
使用稳定的网络环境
备份项目依赖配置

温馨提示

遇到问题先看日志
不要盲目尝试，逐步排查
必要时可以清理缓存重新开始