Android Studio最新版本无法添加图片至mipmap目录，构建失败如何解决？

阿华AIGC实验室

2026-5-21

解决Android Studio无法向mipmap目录添加图片的问题

嘿，我来帮你搞定这个困扰你的问题！下面是几个经过验证的解决步骤，你可以一步步尝试：

切换项目视图模式
最新版Android Studio默认用的是Android视图，这个视图会把资源目录按类型分组，有时候你看到的mipmap并不是真实的文件系统目录。你可以切换到Project视图（左侧面板顶部的下拉菜单里就能选），找到app/src/main/res下的各个mipmap-xxx目录，直接把图片拖进去，或者右键目录选New > Image Asset（生成适配图标）/New > File手动添加。
用Asset Studio规范添加资源
如果是要添加应用图标这类资源，AS自带的Asset Studio是更稳妥的方式，还能避免权限或格式问题：
1. 右键res目录，选择New > Image Asset
2. 在弹出窗口里选Icon Type为Launcher Icons (Adaptive and Legacy)，跟着提示选择源图片，AS会自动生成适配各种分辨率的图标到对应mipmap目录，还能规避手动命名的错误。
检查文件命名与系统权限
Android资源文件名有严格规则：只能用小写字母、数字、下划线和点，不能有空格或特殊字符。另外，如果是从外部复制的图片，可能带系统权限限制，你可以先把图片复制到电脑普通文件夹（比如桌面），再拖进AS的mipmap目录。
清理缓存并重启AS
有时候是AS缓存出了问题：
1. 点击File > Invalidate Caches...
2. 勾选Invalidate and Restart，等AS重启后再尝试添加文件。
检查gradle配置是否异常
极少数情况下，gradle脚本的资源配置可能限制了mipmap目录修改。打开模块级的app/build.gradle，检查android块下的sourceSets配置，确保没有对res目录做特殊限制，比如：
```
android {
    sourceSets {
        main {
            res.srcDirs = ['src/main/res']
        }
    }
}
```
若有多余配置，尝试恢复默认后点击右上角Sync Now同步gradle。