提交更新(git commit)

提交更新(git commit)

提交更新是Git版本控制中最核心的操作之一。它将暂存区的修改永久保存到本地仓库，形成一个新的版本记录。每次提交都会生成一个唯一的SHA-1哈希值作为标识。

基本提交操作

最简单的提交命令只需要添加提交信息：

git commit -m "修复登录页面样式问题"

这个命令会将所有已暂存(staged)的修改提交到本地仓库。提交信息应当简明扼要地描述本次修改的内容。

查看提交历史

提交后可以使用git log查看提交记录：

git log --oneline

输出示例：

a1b2c3d (HEAD -> main) 修复登录页面样式问题
e4f5g6h 初始化项目结构

修改最后一次提交

有时提交后发现信息有误或漏掉文件，可以使用--amend选项修改最后一次提交：

git commit --amend -m "修复登录页面按钮样式问题"

如果要添加漏掉的文件：

git add forgot-file.js
git commit --amend --no-edit

多文件提交的最佳实践

建议将逻辑上相关的修改一起提交，不相关的修改分开提交。例如：

# 提交登录功能相关修改
git add login.html login.css login.js
git commit -m "实现登录页面前端逻辑"

# 提交注册功能相关修改
git add register.html register.css register.js
git commit -m "完成注册页面表单验证"

提交信息规范

良好的提交信息应当遵循以下格式：

类型(范围): 简短描述

详细说明（可选）

相关issue（可选）

示例：

fix(auth): 修复密码强度验证逻辑

密码强度验证现在会检查特殊字符
最小长度要求从6改为8

Closes #123

常见类型包括：

• feat：新功能
• fix：错误修复
• docs：文档变更
• style：代码格式
• refactor：重构代码
• test：测试相关
• chore：构建过程或辅助工具变更

交互式提交

对于复杂的修改，可以使用交互式提交：

git commit -p

这会逐个显示修改的差异块，询问是否要包含在本次提交中。非常适合将一个大修改拆分成多个逻辑提交。

空提交

有时需要创建一个不包含任何改动的提交，比如触发CI/CD：

git commit --allow-empty -m "触发部署流程"

提交签名验证

为了确保提交的真实性，可以添加GPG签名：

git commit -S -m "安全更新"

需要事先配置GPG密钥。

提交模板

可以创建提交信息模板提高一致性：

git config --global commit.template ~/.gitmessage

模板文件示例：

# <类型>(<范围>): <主题>
# |<----  最多50个字符  ---->|

# 详细说明，72字符换行

# 可选脚注
# Closes #<issue编号>

提交钩子

Git支持在提交前后自动执行脚本。例如在.git/hooks/pre-commit中添加：

#!/bin/sh
npm run lint

这会确保每次提交前都通过代码检查。

撤销提交

如果提交了错误的修改，可以使用：

git reset HEAD~1

这会撤销最后一次提交但保留修改在工作区。如果要完全丢弃修改：

git reset --hard HEAD~1

部分提交

有时只需要提交文件的部分修改：

git add -p

然后选择要暂存的修改块，最后提交。

提交范围选择

提交时可以指定只提交某些路径的修改：

git commit src/ utils/ -m "更新工具函数"

提交策略建议

1. 小而频繁的提交优于大而少的提交
2. 每个提交应当是一个完整、可工作的修改
3. 提交信息要清晰表达修改意图
4. 避免提交自动生成的文件或临时文件
5. 公共分支上的提交历史应当保持整洁

跨平台换行符问题

Windows和Unix系统的换行符不同可能导致整个文件显示为修改。可以配置Git自动处理：

git config --global core.autocrlf true

提交与分支的关系

每次提交都会基于当前分支创建新版本。使用git branch --contains <commit>可以查看包含某次提交的分支。

二分查找问题提交

当引入bug但不确定是哪次提交导致时：

git bisect start
git bisect bad
git bisect good a1b2c3d

Git会自动二分检查，直到找到问题提交。

提交统计

查看提交统计信息：

git shortlog -sn

显示每个贡献者的提交次数。

提交差异比较

比较两次提交间的差异：

git diff a1b2c3d..e4f5g6h

重写提交历史

对于已经推送的提交，可以使用交互式变基修改：

git rebase -i HEAD~3

然后可以重新排序、合并或修改提交信息。注意这会改变提交哈希值。