Git 的正确使用姿势与最佳实践：团队协作和版本控制的最佳实践｜ 青训营

当今的软件开发中，版本控制非常的重要，而 Git 是当今非常热门的分布式版本控制系统，是团队协作和代码管理的强大工具。而正确地使用 Git对于确保项目的稳定性、可维护性和团队协作至关重要。

1. 代码仓库组织

远程仓库管理

# git remote 是用来管理远程仓库的命令
​
git remote      # 查看已配置的远程仓库
git remote -v   # 查看远程仓库的URL
git remote add     # 添加一个新的远程仓库
# e.g git remote add origin ，一般采用origin作为远程仓库的名字
git remote remove origin            # 删除名为origin的远程仓库
git remote rename origin newname    # 将origin的名字改为newname

从工作区提交代码到远程仓库

# git add 将更改过的代码添加到暂存区
git add .   # 将工作区中所有更改添加到暂存区
git add index.html  # 添加更改的单个文件到暂存区
git add src/        # 添加该目录下的更改到暂存区
​
# git commit 将暂存区的代码提交大本地仓库
git commit -m "提交说明"    # 最常用的提交方式，一定要写提交说明，不然版本管理会非常痛苦
​
# git push 用于将本地的代码提交推送到远程仓库，将本地仓库中的提交上传到Git服务器上，使其成为远程仓库的一部分
git push  :
git push -f origin master   # 强制推送到origin的master分支，远程仓库origin的master分支上的之前的代码会被覆盖！非常危险的操作！

• ：指定要推送到的远程仓库的名称，通常为"origin"，这是Git默认的远程仓库名称。
• ：指定要推送的本地分支的名称，这是你当前所在的分支，例如"main"、"master"等。
• ：指定远程仓库中要接收提交的分支名称。

默认情况下，git push命令会将当前分支的代码推送到与之相对应的远程分支。例如，如果你当前在"main"分支上，并且与远程仓库"origin"关联，那么git push origin main命令将把"main"分支的提交推送到"origin"的"main"分支；如果远程分支不存在，则git push会自动创建一个新的远程分支。

2. 提交规范和消息清晰

良好的提交规范和清晰的提交消息可以大大提高代码审查、版本跟踪和项目维护的效率。每次提交应该只关注一个逻辑变更，并且提交消息应该简洁但具有描述性。一种常见的提交消息结构是：

feat: add user authentication

- Added user authentication feature
- Implemented login and registration functionality
- Used bcrypt for password hashing

3. 分支管理与合并

分支管理

# git branch 命令用于查看、创建和管理分支

git branch 					# 查看本地所有分支
git branch -a				# 查看本地和远程的分支
git branch 		# 创建一个新分支
git branch -d 	# 删除一个分支
git branch -D  	# 强制删除一个分支

# git checkout 用于在Git中切换分支、查看文件的不同版本或还原文件到之前的状态
关于git rebase的黄金法则就是永远不要在公共分支上使用它。
git checkout 						 # 切换到其他分支上
											 # 新版本git中采用git switch  切换分支
git checkout  			# 查看文件的不同版本
git checkout  -- 		# 还原文件到之前的状态

合并请求示例：

• 将特性分支投递
• 团队成员讨论得出最终代码
• 代码审查后，合并到 develop 分支

4. 定期代码同步

团队成员需要常常从 develop 分支取得最新的代码，以保持自己的分支与主分支同步。这有助于减少分支间的差异，降低合并冲突的风险。定期同步可以通过以下步骤完成：

$ git checkout feature/user-authentication
$ git pull origin develop

5. 标签和版本发布

每次发布稳定版本时，应该为该版本创建一个标签。标签可以用来标识特定版本的代码，方便日后查找和回溯。创建标签的步骤如下：

实例：

$ git checkout master
$ git pull origin master
$ git tag -a v1.0.0 -m "Release version 1.0.0"
$ git push origin --tags

结论

学会使用git可以迅速的提高团队的合作效率和代码质量。通过清晰的代码仓库组织、规范的提交消息、合理的分支管理、定期的代码同步、标签和版本发布，以及持续集成和自动化测试，团队成员可以好好学习git熟练掌握，不论是在当前的项目开发或是以后的工作都十分重要。