Android Studio新手求助：assets文件夹部分文件未打包进APK

阿华AIGC实验室

2026-5-26

解决Android Studio中Assets文件夹图片未打包进APK的问题

Hey there, let's work through this issue step by step—since you've already ruled out syncing options, let's dig into some common pitfalls that often trip up new Android Studio users:

检查图片文件名的合规性
Android对assets目录下的文件名有隐性要求：尽量避免空格、特殊字符（比如中文、@、#），也别用大写字母（虽然不是硬性规定，但容易引发索引问题）。把缺失的图片改成小写字母+下划线的命名格式，比如user_avatar.png，再重新打包试试。
确认assets文件夹的正确位置
确保你的assets文件夹严格位于src/main/assets目录下，而不是放在src/test、模块外部，或者其他错误路径里。如果是多模块项目，还要确认你修改的是当前正在打包的目标模块的assets文件夹。另外，子文件夹结构也要检查，比如图片放在assets/icons/下时，路径拼写不能出错，打包时会完整保留这个层级。
清理缓存并彻底重构项目
旧的构建缓存很可能导致新修改的资源不被纳入打包。试试这一套操作：
1. 点击顶部工具栏的Build -> Clean Project
2. 接着点击Build -> Rebuild Project
3. 最后重新生成APK
  这个流程会清除所有旧的构建产物，强制Android Studio重新编译、打包所有资源。
检查build.gradle的资源配置
打开模块级的build.gradle（一般是app/build.gradle），确认有没有通过sourceSets配置排除了某些文件。正常情况下默认配置会包含整个assets文件夹，但如果看到类似下面的代码，要检查是否不小心排除了你的图片：
```
sourceSets {
    main {
        assets {
            exclude '**/missing_image.png'
        }
    }
}
```
如果有这类排除规则，直接移除或者调整为包含目标图片的规则。
强制重新索引资产文件
有时候Android Studio没及时索引到新添加的图片。右键点击assets文件夹，选择Reload from Disk，或者直接重启Android Studio，让软件重新识别目录下的所有文件。
核对构建变体的配置
如果你使用了不同的构建变体（比如debug和release），要确认你修改的assets属于当前打包的变体，或者有没有变体专属的配置覆盖了默认assets目录。可以通过Build Variants面板切换到你打包的变体，再检查对应assets文件夹的内容是否正确。