Android Studio Git 管理最佳实践

核心操作流程

1. 初始化与配置

bash 复制代码

# 初始化本地仓库
git init

# 配置用户信息
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

# 查看配置
git config --list

2. 日常操作三步曲

提交代码：

bash 复制代码

# 1. 查看状态
git status

# 2. 添加文件
git add .                    # 添加所有文件
git add filename.java       # 添加单个文件
git add src/                # 添加目录

# 3. 提交
git commit -m "feat: 添加用户登录功能"

获取更新：

bash 复制代码

# 拉取远程更新
git pull origin main

# 拉取指定分支
git pull origin develop

推送代码：

bash 复制代码

# 推送到远程
git push origin main

# 推送新分支
git push -u origin feature/new-feature

.gitignore 文件管理

创建与编辑

Android Studio 标准 .gitignore：

gitignore 复制代码

# Android Studio 项目
*.iml
.gradle/
/local.properties
/.idea/caches/
/.idea/libraries/
/.idea/modules.xml
/.idea/workspace.xml
/build/
/captures/
.externalNativeBuild/
.cxx/

# 敏感配置文件
gradle.properties
local.properties

# 系统文件
.DS_Store
Thumbs.db

# 日志文件
*.log

编辑技巧

添加忽略规则：

bash 复制代码

# 直接编辑文件
echo "gradle.properties" >> .gitignore

# 或使用编辑器打开
notepad .gitignore    # Windows
nano .gitignore       # Linux/Mac

验证忽略效果：

bash 复制代码

# 查看被忽略的文件
git status --ignored

# 检查特定文件是否被忽略
git check-ignore -v filename

分支管理策略

标准分支模型

复制代码

main/master     # 生产环境代码
develop         # 开发主分支
feature/*       # 功能开发分支
hotfix/*        # 紧急修复分支

分支操作

bash 复制代码

# 创建并切换分支
git checkout -b feature/user-login

# 切换分支
git checkout develop

# 查看所有分支
git branch -a

# 合并分支
git checkout main
git merge feature/user-login

# 删除分支
git branch -d feature/user-login

冲突解决流程

合并冲突处理

bash 复制代码

# 1. 拉取更新时出现冲突
git pull origin main

# 2. 查看冲突文件
git status

# 3. 手动解决冲突后
git add .
git commit -m "resolve: 解决合并冲突"

# 4. 推送解决后的代码
git push origin main

最佳实践要点

提交信息规范

复制代码

类型(模块): 简要描述

详细描述（可选）

修复: #123

类型标识：

feat: 新功能
fix: 修复bug
docs: 文档更新
style: 代码格式调整
refactor: 重构
test: 测试相关
chore: 构建工具或辅助工具变动

安全配置管理

敏感信息（API Key、密码）放入 local.properties
gradle.properties 添加到 .gitignore
提供 gradle.properties.template 模板文件

团队协作检查清单

常见问题解决

文件已提交后如何忽略

bash 复制代码

# 1. 添加到 .gitignore
echo "sensitive-file.txt" >> .gitignore

# 2. 从版本控制中移除
git rm --cached sensitive-file.txt

# 3. 提交更改
git commit -m "chore: 移除敏感文件并更新 .gitignore"

恢复误删文件

bash 复制代码

# 恢复工作区文件
git checkout -- filename

# 恢复已删除的文件
git checkout HEAD -- deleted-file

这套流程确保代码安全、团队协作顺畅，避免敏感信息泄露。