安装Flutter包时附带示例项目致体积暴涨，如何缩减项目大小？

我来帮你搞定这个头疼的问题！你遇到的情况非常普遍——很多Flutter第三方包（比如shared_preferences）在安装时会自动下载平台专属的示例代码、Pod缓存、Android测试资源这类对业务完全没用的内容，正是它们把你的项目从1-2MB撑到了136MB。下面是针对性的清理方案和预防措施：

一、先搞清楚体积膨胀的核心原因 #

简单说：第三方包为了方便开发者学习使用，会附带示例项目、文档甚至测试文件，但这些内容根本不是你的项目运行所必需的，完全可以安全删除。

二、分步清理冗余内容 #

1. iOS端清理 #

• 先清理Pod缓存和冗余依赖：
  进入iOS目录：

  cd ios
  

  清除所有Pod缓存：

  pod cache clean --all
  

  删除旧的Pods目录和锁文件：

  rm -rf Pods Podfile.lock
  

  重新安装不带文档的Pod依赖（文档占了不少体积）：

  pod install --no-documentation
  

• 手动删除包自带的示例文件夹：检查ios/目录下是否有Example之类的文件夹，直接删掉就行，不影响功能。

2. Android端清理 #

• 清除Gradle构建缓存：
  进入Android目录：

  cd android
  

  执行清理命令：

  ./gradlew clean
  

• 移除多余的示例模块：有些包会在android/下添加sample模块，找到对应的目录删除，然后打开settings.gradle，把该模块的引用删掉。

3. Web端清理 #

• 检查web/文件夹：如果有第三方包添加的示例页面、测试静态文件，直接删除多余的HTML、JS资源。
• 执行Flutter Web缓存清理：

  flutter clean
  

4. 全局深度清理 #

• 先执行Flutter全局清理，删除项目的build/、.dart_tool/等缓存目录：

  flutter clean
  

• 删除项目根目录或平台目录下的example/文件夹：很多包安装后会自动生成这个示例目录，直接删掉就行。

三、预防：避免后续安装包时再踩坑 #

• 安装包时用--no-example参数：从Flutter 2.0开始，支持跳过示例资源安装，比如安装shared_preferences时用这个命令：

  flutter pub add shared_preferences --no-example
  

• 定期清理缓存：建议每月执行一次flutter clean + 各平台的缓存清理，避免缓存堆积。
• 手动排查依赖：如果已经安装了带示例的包，直接删除项目中所有和该包相关的示例文件夹，再执行flutter pub get更新依赖即可。

四、验证清理效果 #

按照上面的步骤操作后，你可以重新测试：

1. 执行flutter clean后查看项目体积
2. 用--no-example参数重新安装需要的包
3. 对比前后体积，应该能回到接近初始项目的大小，同时完全不影响包的正常使用。

内容的提问来源于stack exchange，提问作者MaheshPeri19