first-contributions 入门实战用 git commit --amend 修正提交信息与遗漏变更【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions本文基于 first-contributions 仓库中的法语教程 amending-a-commit.fr.md对应英文原文 amending-a-commit.md展开系统讲解git commit --amend的完整用法如何在不打开编辑器的情况下修改已推送的提交信息以及如何把一次遗漏的细微修改并入既有提交而不是新增一个补丁提交。读完后你将掌握 amend 的操作步骤、与 force push 配合的边界条件以及 amend 与其他历史修正手段revert、squash、reset的适用关系。典型场景提交已经推送到远程却发现出错first-contributions 仓库的 Git 工作流文档将“修正提交”列为初学者最常见的进阶场景假设你已经把一次提交推送到了远程仓库之后才意识到提交信息里有拼写错误或者你忘记在最后那个提交中加入某一行内容——这时该怎么纠正这正是git commit --amend要解决的问题。它的作用是重做最近一次提交生成一个新的提交来替换旧的提交内容可以是原内容加上新改动并保留或改写提交信息。下面分两种情况展开两种情况都完整继承了法语教程中的原始操作步骤。场景一修改最近一次提交的提交信息如果你只想改掉最近一次提交的 message并且不想打开任何文件教程给出的最小操作序列是git commit --amend -m followed by your new commit message git push origin branch-name第一条命令直接用-m选项提供新的提交信息不会打开文本编辑器一步完成改写第二条命令把修正后的提交推送到远程分支。教程中特别给出了一条备注Note如果只输入git commit --amend而不带任何选项Git 会打开你配置的文本编辑器由core.editor决定提示你编辑提交信息加上-m参数正是为了跳过这一编辑器交互让操作完全在命令行内完成。从命令行为上理解git commit --amend本质上是“把暂存区中的内容与上一次提交的树合并生成一个全新的提交对象”旧提交随即被新提交取代。这一点在后续讨论 force push 时尤为关键。场景二把一次遗漏的细微修改并入既有提交法语教程用了一段真实的提交日志来说明第二种更典型的场景g56123f création dun fichier bot a2235d mise à jour de contributeur.md a5da0d modification du fichier bot英文原文对应为create file botfile/updated contributor.md/modified botfile。假设你发现自己在botfile中漏写了一个单词且a5da0d这次提交已经推送到了远程仓库。此时有两种处理路径路径一新增一个补丁提交。改动会体现为一条新的提交记录g56123f création dun fichier bot a2235d mise à jour de contributeur.md a5da0d modification du fichier bot b0ca8f ajout dun mot dans le fichier bot路径二amend 目标提交。直接改写a5da0d这次提交把新加的词并入其中最终推送到远程的仍然是同一个被改写的提交。教程明确指出对于这种细微修改minor change第二种方式更合适——历史里不会残留一条“加了一个单词”的噪音提交。amend 既有提交的具体步骤教程给出的完整操作流程如下每一步都对应一条可复制执行的命令修改文件把遗漏的词补进botfile把文件加入暂存区git add nom-du-fichier执行 amend 而不是普通 commit。平时暂存之后我们会运行git commit -m notre message de commit但这里的目标是改写上一次提交因此运行git commit --amend这会打开文本编辑器提示你编辑提交信息——你可以决定保持原信息不变也可以顺手改掉退出编辑器完成新提交推送更改git push origin nom-de-la-branche完成这五步后原本的两个变更就落在同一个提交里了les deux changements se trouvent dans un même commit。需要理解的一个细节当被 amend 的提交不是本地 HEAD、而是历史上较早的一次提交如示例中的a5da0d其之上还有a2235d、g56123f时单纯git commit --amend只能改写最近一次提交要改写中间某次提交需要借助交互式变基git rebase -i把目标提交标记为edit/reword后再完成 amend。仓库的英文原文将此类改写中间提交归入了更通用的历史重写范畴相关流程可结合同目录下的 rebase-vs-merge.md 了解 rebase 与 merge 对历史形态的差异影响。补充纵深amend 已推送提交时的 force push 边界法语译文目前覆盖了前两个场景其对应的英文原文 amending-a-commit.md 还补充了第三个关键场景——当被 amend 的提交已经推送到远程时如何处理这里一并继承讲解使整套操作流程闭合。原文指出如果待 amend 的提交已经推送到远程amend 之后本地历史会与远程分叉diverge——因为你实际上是创建了一个新提交来替换被改写的提交。既然你的目标是让远程分支上的提交也变成新的那个就必须用强制推送覆盖远程历史git add your changed files git commit --amend -m followed by your new commit message git push --force原文在此附带了一条警告Warning原文语义必须完整保留强制推送会覆盖并丢弃远程上的更改只保留你推送的提交在此期间其他团队成员在远程上做的更改也会被一并覆盖。作为更安全的替代原文建议使用--force-with-lease代替--force它在你推送前校验远程引用是否仍与你上次所见一致从而避免覆盖他人推上来的新提交前提是你本就不打算保留那些提交。何时该用 amend何时该用其他手段amend 的适用边界可以从仓库的姊妹文档中得到印证——additional-material.fr.md 法语索引页将以下工作流场景并列列出各自对应不同的修正诉求只想回退远程上某次提交、保留历史应使用 revert见 reverting-a-commit.md它通过新增一个反向提交来抵消改动不重写历史适合多人协作的共享分支想在本地放弃某次提交、回到之前状态见 undoing-a-commit.md提交前想确认目标提交的信息与内容配合 check-commit-log.fr.md 中的git log系列命令如git log -n 5限制条数、git log --all fichier查看某文件历史先定位提交短 ID再执行 amend评审者要求把多个提交压成一个见 squashing-commits.md。从这些文档的分工可以看出一个实用判断准则amend/force push 重写历史只适合个人分支或确定无他人基于该历史工作的场景revert 不重写历史适合共享分支的公开修正。first-contributions 作为新人贡献入口仓库这一区分对新人在 feature 分支上自我纠错尤其重要。小结与可验证路径本文继承并扩展了法语教程的两条核心操作线git commit --amend -m ...git push origin branche无编辑器改提交信息修改文件 →git add fichier→git commit --amend→ 退出编辑器 →git push origin branche把遗漏的细微修改并入既有提交英文原文补充的边界场景已推送提交的 amend 需要git push --force推荐--force-with-lease并附带覆盖他人改动的风险警告。所有操作步骤均可在以下仓库路径中对照查证法语教程 amending-a-commit.fr.md、英文原文 amending-a-commit.md、法语索引 additional-material.fr.md以及法语版主教程 README.fr.md 中的首次贡献完整流程。【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考