Windows 下 Android Studio 配置 Git 及 GitHub/Gitee 版本管理
1. 环境准备
- 注册 GitHub 账号。
- 确保网络连接正常,能够访问远程仓库服务。
2. 安装 Git
下载地址:https://git-scm.com/download/win 根据系统选择对应版本(如 x64)。安装时建议勾选除更新检查外的所有组件,后续页面点击 Next 完成安装。
3. 配置 Android Studio
- 打开 Android Studio,点击顶部菜单栏 File → Settings(Mac 为 Android Studio → Preferences)。
- 展开左侧菜单 Version Control → Git。
- 在 Path to Git executable 栏中,点击右侧按钮找到 Git 安装路径下的 git.exe(默认路径通常为 C:\Program Files\Git\bin\git.exe),选中后点击 OK。
4. 配置系统环境变量
- 按下 Win + R,输入 sysdm.cpl,回车打开「系统属性」窗口。
- 切换到「高级」选项卡,点击右下角的「环境变量」。
- 在「系统变量」列表中找到名为 Path 的变量,双击编辑。
- 新建条目,粘贴 Git bin 目录路径(例如 C:\Program Files\Git\bin)。
- 再次新建条目,粘贴 Git cmd 目录路径(例如 C:\Program Files\Git\cmd)以兼容更多命令。
- 依次点击确定关闭所有窗口。配置后需重启终端或 IDE 生效。
5. 验证配置
- 在 CMD 中输入
git --version,若输出版本号则说明成功。 - 在 Android Studio 的 Terminal 终端输入
git --version,确认输出一致。
6. 初始化本地仓库
- 打开 Android Studio,加载项目。
- 点击 VCS → Import into Version Control → Create Git Repository。
- 选择项目根目录,点击 OK 完成初始化。
7. 提交代码
- 右键项目根目录 → Git → Add(暂存文件)。
- 右键项目根目录 → Git → Commit Directory。
- 填写 Commit message,确认文件列表,取消勾选 Perform code analysis 和 Check TODO 以提升速度,点击 Commit。
8. 常见问题处理
问题: Commit 失败,提示 pathspec did not match any files。 解决: 在 Android Studio Terminal 依次执行以下命令:
# 清除 Git 索引缓存
git rm -r --cached .
# 重新将所有文件加入暂存区
git add .
9. 推送至远程仓库
在 Terminal 输入命令:
git push -u origin main
首次推送会提示登录认证,网页端登录后即可成功提交。
10. 切换至 Gitee
若 GitHub 连接不稳定,可迁移至国内码云 Gitee:

