1.5 实验：从 Git 仓库导入 Android 项目
1.1 什么是 Git？
Git 是目前全球使用最广泛的分布式版本控制系统，由 Linux 之父 Linus Torvalds 于 2005 年创建。它可以记录文件的每一次修改历史，让你随时回退到任意历史版本，也让多人协作开发变得更加高效、安全。
在 Android 开发中，Git 的常见使用场景包括：
| 场景 | 说明 |
|---|---|
| 获取老师或同学分享的项目 | 通过 git clone 克隆远程仓库到本地 |
| 多人团队协作开发 | 通过分支（Branch）隔离各自工作，再合并 |
| 项目版本追踪 | 记录每次提交（Commit），随时可以回滚 |
| 代码备份 | 推送（Push）到 GitHub / Gitee 等远程平台保存 |
💡 常见 Git 托管平台
1.2 核心概念速览
| 术语 | 含义 |
|---|---|
| 仓库（Repository） | 存放项目代码及历史记录的地方，简称 Repo |
| 克隆（Clone） | 将远程仓库完整下载到本地 |
| 提交（Commit） | 将当前修改保存为一次版本记录 |
| 分支（Branch） | 同一仓库中相互独立的开发线路 |
| 推送（Push） | 将本地提交上传到远程仓库 |
| 拉取（Pull） | 将远程仓库的最新更新下载到本地 |
2.1 检查是否已安装 Git
在进行安装之前，先检查系统中是否已经存在 Git。
打开命令提示符（CMD） 或 PowerShell，输入以下命令：
git --version- 如果输出类似
git version 2.x.x.windows.x，说明 Git 已经安装，可以跳过安装步骤，直接进入第 2.3 节。 - 如果提示
'git' 不是内部或外部命令，则需要继续按照下面步骤安装。
2.2 下载并安装 Git
方式一：从官网下载（推荐使用镜像加速）
Git 官网下载速度较慢，建议通过以下国内镜像下载：
- 腾讯软件（推荐）: https://sw.pcmgr.qq.com/44beb155f3d436c6f919117d4bb26e38/69f1bbf8/spcmgr/download/Git-2.53.0.3-64-bit.exe
- 阿里云镜像：https://registry.npmmirror.com/binary.html?path=git-for-windows/
- Gitee 镜像：在 Gitee 搜索
git-for-windows获取最新版安装包
下载后得到一个 .exe 安装程序，双击运行。
2.3 安装向导关键步骤说明
Git 安装向导的选项较多，大部分保持默认即可。以下几个选项需要特别注意：
① 选择安装组件（Select Components）
保持默认勾选，确保 Git Bash 和 Git GUI 都被选中。
② 调整 PATH 环境变量（Adjusting your PATH environment）
选择第二项：Git from the command line and also from 3rd-party software（推荐）。
这样可以在系统命令行（CMD / PowerShell）和 Android Studio 中都能直接使用 git 命令。
③ 配置行尾符（Configuring the line ending conversions）
选择第一项：Checkout Windows-style, commit Unix-style line endings。
其余选项均保持默认，点击 Next 直到安装完成，最后点击 Finish。
2.4 验证安装成功
安装完成后，重新打开一个命令提示符或 PowerShell 窗口，再次输入：
git --version如果显示版本号则说明安装成功。
打开命令提示符，运行 git --version，截图显示输出的版本号。
3.1 打开 Git 设置页面
启动 Android Studio，依次打开：
File → Settings → Version Control → Git
（macOS 系统路径为：Android Studio → Preferences → Version Control → Git）
3.2 指定 Git 可执行文件路径
在 Path to Git executable 输入框中，AS 通常会自动探测到 Git 的安装位置。
- 如果路径已经自动填入（如
C:\Program Files\Git\bin\git.exe），说明 AS 已经找到 Git，无需手动设置。 - 如果路径为空，点击右侧文件夹图标，手动定位到 Git 的安装目录，选择
bin\git.exe。
3.3 点击 Test 验证
在路径填好后，点击右侧的 Test 按钮，AS 会执行一次版本检测。
- ✅ 弹出类似
Git 2.x.x的提示框 → 配置成功 - ❌ 显示错误或无响应 → 检查路径是否正确，或重新安装 Git
确认成功后点击 OK 保存设置。
截图显示 Android Studio 的 Git 设置页面，要求能看到：
- Git 可执行文件路径已填写
- 点击 Test 后弹出的成功提示内容
4.1 获取仓库地址
在开始克隆之前，你需要先获取目标 Git 仓库的 Clone URL。 在此实验中，我们可以使用老师提供的示例项目仓库地址：
仓库地址：https://cnb.cool/sziit-coding/android-coding/android-basic/android-labs
4.2 在 Android Studio 中启动克隆
在 Android Studio 中，有两种方式进入克隆界面：
方式一：欢迎页（推荐）
如果当前 AS 显示欢迎页（没有打开任何项目），点击 Get from VCS。
方式二：通过菜单栏
如果 AS 已有项目打开，通过菜单栏选择 File → New → Project from Version Control…
4.3 填写克隆信息并执行
在弹出的 Get from Version Control 对话框中，填写以下信息：
| 字段 | 说明 |
|---|---|
| Version control | 选择 Git |
| URL | 粘贴第 4.1 步复制的 Clone URL |
| Directory | 选择本地保存路径，要求路径不含中文和空格 |
⚠️ 路径注意事项
- 路径中不能含有中文字符
- 路径中不能含有空格
- 建议放在非 C 盘的专用目录，如
D:\AndroidProjects\
填写完成后，点击 Clone 按钮开始克隆。
4.4 等待克隆完成
AS 会在界面底部显示克隆进度，网速较慢时请耐心等待。
克隆完成后，AS 通常会弹出询问是否立即打开项目的对话框，点击 Yes 即可。
4.5 Gradle Sync 与首次运行
项目打开后，AS 会自动触发 Gradle Sync（依赖同步）。首次同步需要下载依赖，可能需要几分钟，请等待底部进度条完成。
Sync 完成后，点击工具栏的绿色运行按钮 ▶，选择目标设备（模拟器或真机），确认项目能够正常编译运行。
截图显示以下内容（可以是一张或多张）：
- AS 中已打开克隆的项目，可以看到项目名称和文件结构
- 项目在模拟器或真机上成功运行的界面
5.1 克隆速度很慢甚至超时
原因：访问 GitHub 时网络不稳定。
解决方法：
- 优先使用 Gitee 上的镜像仓库（国内速度更快）。
- 使用学校/公司内网代理（如有）。
- 在 AS 的 Settings → Appearance & Behavior → System Settings → HTTP Proxy 中配置代理。
5.2 克隆后 Gradle Sync 失败
常见原因：Gradle 插件版本与 AS 版本不兼容，或网络无法下载依赖。
解决方法：
- 查看 Build 面板的具体报错信息。
- 参考 1.3 实验：导入已有 Android 项目 中的 Gradle Sync 问题处理步骤。
- 确认镜像源配置（
settings.gradle.kts中的仓库配置）是否正确。
5.3 提示 “Repository not found” 或 “Authentication failed”
原因：仓库地址错误，或私有仓库需要登录授权。
解决方法：
- 检查 Clone URL 是否完整（末尾包含
.git）。 - 如果是私有仓库，在 AS 弹出的登录框中输入 GitHub / Gitee 账号和密码（或 Personal Access Token）。
- GitHub 已不再支持密码登录，需要使用 Personal Access Token（PAT） 代替密码。