Android Studio Git 完全配置指南：从环境搭建到首次代码提交

原创已于 2025-07-16 00:42:23 修改 · 1.9k 阅读

20 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#git #android studio #androidx #jdk #java

于 2025-07-16 00:40:59 首次发布

标题# Android Studio Git 完全配置指南：从环境搭建到首次代码提交

摘要: 本文为Android开发者提供了一份详尽的Git环境搭建与配置指南。从Git的安装、环境变量配置，到SSH密钥的生成与关联，再到Android Studio的深度集成和首次代码提交，本文将一步步带你走完整个流程，助你轻松掌握团队协作开发的必备技能。

标签: Android, Git, Android Studio, 环境配置, 版本控制

1. 前言

在现代软件开发中，版本控制系统（Version Control System）是不可或缺的一环，而Git无疑是其中最流行、最强大的工具。对于Android开发者而言，熟练使用Git进行代码的版本管理和团队协作，是一项必须掌握的核心技能。然而，对于初学者来说，从零开始配置Git环境并将其与Android Studio完美集成，可能会遇到一些困惑。

本文旨在提供一份“保姆级”的教程，引导你完成从Git安装到在Android Studio中成功提交第一次代码的全过程，让你彻底告别版本管理的混乱。

2. Git 安装与环境配置

第一步，我们需要在本地计算机上安装Git。

下载与安装:
访问 Git官方网站下载适合你操作系统的安装包。

安装过程非常简单，大部分选项保持默认即可，但其中最关键的一步是配置PATH环境变量。请确保在安装过程中勾选“Add Git to your PATH”相关的选项（新版的安装器通常会默认选中 Git from the Command Line and also from 3rd-party software，这个选项会自动处理PATH）。这将允许你在任何命令行终端中直接调用 git命令。

验证安装:
安装完成后，打开命令行工具（如CMD或PowerShell），输入以下命令：

git --version

如果成功输出了Git的版本号（如 git version 2.39.2.windows.1），则证明Git已经成功安装并配置到系统环境变量中。正如你的笔记中提到的，安装程序会自动为我们处理好这一切。

3. Git 初始化个人信息

在开始使用Git之前，你需要设置你的用户名和邮箱。这些信息将会被记录在你每一次的代码提交（Commit）中，是你在团队中的“身份标识”。

打开命令行工具，执行以下两条命令，请将 “Your Name” 和 “youremail@example.com” 替换为你自己的信息。

git config --global user.name "Your Name"
git config --global user.email "youremail@example.com"

--global 参数表示这台计算机上所有的Git仓库都会使用这个配置。

4. 生成并配置SSH密钥

为了安全、便捷地与远程仓库（如GitHub、Gitee）进行通信，我们通常使用SSH协议。

生成SSH密钥:
在命令行中输入以下命令，一路回车即可在默认路径下生成密钥文件。

ssh-keygen -t rsa -C "youremail@example.com"

获取并配置公钥:

找到你的SSH公钥文件。它通常位于用户目录下的 .ssh 文件夹中，文件名为 id_rsa.pub。
用记事本或其他文本编辑器打开 id_rsa.pub 文件，复制其中的全部内容。
登录你的代码托管平台（如GitHub），进入个人设置（Settings），找到“SSH and GPG keys”选项，点击“New SSH key”，将刚才复制的公钥粘贴进去，并保存。

5. Android Studio 集成 Git

现在，让我们把Git和我们的主战场——Android Studio关联起来。

打开Android Studio，进入设置 File -> Settings。
在左侧导航栏中找到 Version Control -> Git。
在右侧的 Path to Git executable 中，Android Studio通常会自动检测到你已安装的Git路径。如果没有，请手动指定 git.exe 的完整路径。
点击 Test 按钮，如果IDE提示Git版本号，说明集成成功。

6. 项目版本控制实战

万事俱备，只欠东风。现在我们来为一个Android项目开启版本控制。

6.1 初始化本地仓库

打开或创建一个新的Android项目。在Android Studio的顶部菜单栏中，选择 VCS -> Enable Version Control Integration...，在弹出的窗口中选择 Git 作为版本控制系统。

操作完成后，你会发现项目中的文件都变成了红色，这表示它们还未被Git追踪。

6.2 关联远程仓库

在你的代码托管平台（如GitHub）上创建一个新的空仓库，并复制其SSH地址（格式通常为 git@github.com:YourUsername/YourRepository.git）。
在Android Studio的底部工具栏中打开 Terminal。
输入以下命令，将你的本地仓库与远程仓库关联起来：

git remote add origin git@github.com:YourUsername/YourRepository.git

6.3 首次提交与推送 (First Push)

现在，我们将项目代码提交到仓库中。

添加文件到暂存区 (Add): 右键点击你的项目根目录，选择 Git -> Add。此时，所有文件会变为绿色，表示已暂存。
提交更改 (Commit): 按下 Ctrl + K（或点击顶部工具栏的提交按钮），打开提交窗口。在 Commit Message 中输入有意义的提交信息，例如 “Initial commit”。然后点击 Commit。
推送到远程仓库 (Push): 按下 Ctrl + Shift + K（或选择 Git -> Push...），打开推送窗口。确认无误后，点击 Push。

第一次推送时，IDE可能会让你确认远程分支，按照默认提示操作即可。推送成功后，刷新你的远程仓库页面，就能看到你的项目代码了！