首次使用Android Studio无法运行项目:无module且无Gradle同步选项
解决Android Studio无可用Module及Gradle同步问题的步骤
一、先确认项目导入方式是否正确
无可用Module的常见原因是导入目录错误,按以下步骤重新操作:
- 关闭当前Android Studio窗口,重启软件后选择「File」→「Open」
- 找到你下载/克隆的项目根目录(必须是包含项目级
build.gradle文件的文件夹),选中后点击「OK」
二、手动触发Gradle同步
导入后若未自动同步,通过以下方式执行:
- 点击顶部工具栏的「Sync Project with Gradle Files」按钮(图标为大象旁的刷新箭头)
- 若找不到按钮,直接通过菜单栏「File」→「Sync Project with Gradle Files」触发同步
三、修复无可用Module的问题
同步后仍无Module时,按以下步骤排查:
- 打开「File」→「Project Structure」(快捷键Ctrl+Alt+Shift+S),查看「Modules」页面,若空白如图:

- 打开项目根目录下的
settings.gradle文件,确认存在include ':app'这类声明(该项目的主Module为app) - 若没有该声明,手动添加后保存,再次执行Gradle同步
- 同步完成后,回到「Run/Debug Configurations」页面(即你截图的无可用配置页面:
),就能看到可选择的Module了
额外注意事项
- 确保Android Studio版本与项目依赖的Gradle版本兼容,同步时若提示版本不匹配,按弹窗提示下载对应版本即可
- 同步过程保持网络正常,需下载依赖库,网络异常会导致同步失败
内容的提问来源于stack exchange,提问作者wittream
相关产品推荐
相关产品推荐

