如何在Android Studio中正确初始化Git?
Android Studio 中完成Git初始化及大体积项目上传GitHub操作方案
前置配置检查
- 打开Android Studio设置页(Windows为
File > Settings,macOS为Android Studio > Preferences),进入Version Control > Git配置项 - 在
Path to Git executable栏手动选择本地Git安装路径下的可执行文件(Windows选git.exe,macOS选git二进制文件),点击右侧Test按钮,弹出Git版本号提示即为配置生效,可解决命令行下git init无法执行的问题(多数情况是系统环境变量未配置Git路径导致,AS内手动指定路径可直接绕开该问题)
可视化执行Git初始化
- 打开目标Android项目,点击顶部菜单栏
VCS > Create Git Repository - 在弹出的路径选择弹窗中,选中当前项目的根目录,点击
OK即可完成初始化。该操作等价于命令行执行git init,AS会自动在项目根目录生成.git隐藏目录,初始化完成后项目内未跟踪的文件会显示为红色。
大体积项目适配(解决无法直接上传GitHub、Git LFS失效问题)
- 首先配置忽略规则,排除不需要提交的编译产物、本地配置文件,从根源降低代码体积:打开项目根目录下的
.gitignore文件,补充以下规则:
# 编译输出产物 /build /app/build *.apk *.aab *.ap_ *.dex # 本地IDE与构建配置 .idea/ .gradle/ local.properties *.iml # 系统临时文件 .DS_Store Thumbs.db
- 配置Git LFS跟踪大文件:回到设置页的
Version Control > Git LFS项,点击Add按钮,添加需要LFS跟踪的大文件规则(比如*.so、/app/src/main/assets/ai_model/*.bin这类单文件超过100MB的资源),AS会自动生成对应.gitattributes配置文件,无需手动执行LFS命令,避免命令行下LFS不生效的问题。
关联远程仓库并推送
- 点击顶部菜单栏
Git > GitHub > Share Project on GitHub - 首次使用需在弹窗中通过GitHub个人访问令牌完成账号授权
- 填写远程仓库名称、访问权限(公有/私有)、描述信息后,点击
Share即可自动完成首次提交与推送,无需手动执行远程仓库关联、push等命令。
注意:如果之前执行过失败的Git初始化、LFS配置操作,先删除项目根目录下残留的
.git文件夹、.gitattributes文件后再走上述流程,避免旧的错误配置干扰。
内容的提问来源于stack exchange,提问作者황희윤
相关产品推荐
相关产品推荐

