You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在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,提问作者황희윤

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.30 16:15:32