当前位置:

首页 > 编程开发 > git提交时怎么只选部分修改?手把手教你精准暂存

git提交时怎么只选部分修改?手把手教你精准暂存

从普通目录完成第一次本地提交其实并不难,难的是真实开发很少会一直保持"只改一个文件,然后立刻提交"这种理想状态。 写一个功能的时候,往往会出现好几种情况混在一起: 当前真正要提交的代码; 顺手改了一下但应该单独提交的文档; 运行程序产生的日志文件; 只属于本机环境、不上传配置。 这时候,add 和

本文目录

    从普通目录完成第一次本地提交其实并不难,难的是真实开发很少会一直保持"只改一个文件,然后立刻提交"这种理想状态。

    git提交时怎么只选部分修改?手把手教你精准暂存

    写一个功能的时候,往往会出现好几种情况混在一起:

    • 当前真正要提交的代码;
    • 顺手改了一下但应该单独提交的文档;
    • 运行程序产生的日志文件;
    • 只属于本机环境、不上传配置。

    这时候,add 和 commit 本身并不难,真正需要判断的是:

    哪些变化属于这次提交,哪些应该留在外面?

    四个检查窗口

    一次提交前后,可以从四个角度观察仓库:

    想知道什么命令
    哪些路径发生了变化,分别位于哪一层git status --short
    工作区相对暂存区还有哪些具体变化git diff
    暂存区相对当前提交准备记录什么git diff --cached,也可以使用 git diff --staged
    提交完成后形成了什么历史git log --oneline、git show

    status 先告诉我们"哪里有变化",diff 再说明"内容怎么变的",log 和 show 用于提交后核对已经形成的记录。简单来说,就是一套从"发现问题"到"确认结果"的完整流程。

    准备独立实验仓库

    下面的初始化和第一次提交只用于建立一个可复现的前置状态。如果本地已有同名目录,建议换一个新名字。

    mkdir commit-check-lab
    cd commit-check-lab
    git init
    git config user.name "Git Blog Lab"
    git config user.email "git-blog@example.invalid"
    
    printf "login validationn" > app.txt
    printf "old documentationn" > README.md
    git add app.txt README.md
    git commit -m "chore: initialize commit check lab"

    现在仓库里有一个初始提交,工作区是干净的。

    先处理不应进入仓库的文件

    运行程序时经常会产生日志,本地开发也可能需要只属于个人环境的配置。先制造两个未跟踪文件:

    printf "debug outputn" > debug.log
    printf "local development configurationn" > .env
    git status --short

    输出会包含:

    ?? .env
    ?? debug.log

    它们都是工作区中的未跟踪文件。如果直接执行 git add .,就可能把不该进仓库的东西也一起放进暂存区。

    解决方法是在仓库根目录创建 .gitignore:

    printf "*.logn.envn" > .gitignore
    git status --short

    现在输出中不再显示 debug.log 和 .env,只会出现新的 .gitignore:

    ?? .gitignore

    忽略规则本身是项目约定,应该进入版本历史:

    git add .gitignore
    git commit -m "chore: ignore logs and local environment files"

    .gitignore 的两个边界

    第一,.gitignore 主要影响尚未被跟踪的路径。文件如果已经进入提交,后来补写忽略规则并不会自动停止跟踪。

    如果误跟踪的是普通日志或本地生成文件,可以在写好忽略规则后停止跟踪:

    git rm --cached <文件>
    git add .gitignore
    git commit -m "chore: stop tracking generated file"

    --cached 会把删除记录放入暂存区,但保留本地工作区文件。目录需要配合 -r 使用。执行后应先用 git status 确认暂存内容,再提交这次规则变更。

    第二,忽略规则不是凭据泄露后的补救工具。密钥、Token 或密码一旦进入历史,应立即轮换或作废,再根据团队流程处理仓库历史。仅仅删除文件或补写 .gitignore,不能让已经泄露的值失效。

    制造一个混合修改现场

    printf "check empty usernamen" >> app.txt
    printf "new usage examplen" >> README.md
    printf "another debug linen" >> debug.log
    git status --short

    输出:

     M README.md
     M app.txt

    debug.log 仍存在于本地,但因为匹配 .gitignore,不会出现在普通状态结果中。

    git status --short 在文件名前使用两个位置显示状态,可以写成:

    XY 文件名
    • 第一个位置 X:已经进入暂存区的变化;
    • 第二个位置 Y:仍在工作区、尚未暂存的变化。

    当前两个文件显示为 M:第一个位置为空,第二个位置是 M,说明文件只在工作区发生了修改,还没有进入暂存区。

    diff:检查具体改了什么

    先检查准备作为当前功能提交的文件:

    git diff -- app.txt

    这里会看到新增的 check empty username。

    再检查文档:

    git diff -- README.md

    这里会看到另一个独立意图:补充使用示例。

    普通 git diff 比较的是工作区和暂存区,不会展示普通未跟踪文件的内容。因此,检查现场时不能只看 diff,还要先看 status;否则可能漏掉尚未跟踪、也未被忽略的文件。

    只选择属于本次提交的变化

    这次先提交登录校验,不把文档修改混进去:

    git add app.txt
    git status --short

    输出:

     M README.md
    M  app.txt

    app.txt 的 M 进入左列,说明它已经被暂存;README.md 的修改仍在工作区。

    提交前检查暂存区中的实际内容:

    git diff --cached -- app.txt

    这里只应该出现与登录校验有关的变化。确认边界正确后再提交:

    git commit -m "feat: validate empty username"

    一次提交可以同时包含代码、测试和必要文档,关键不是"只能改一个文件",而是这些变化能否共同表达同一个意图,并且可以一起评审和撤销。

    提交后不要立即离开

    提交完成后先看状态:

    git status --short

    输出:

     M README.md

    这说明功能变化已经提交,文档修改仍然安全地留在工作区。提交不会自动带走没有进入暂存区的变化。

    接着查看最近历史:

    git log --oneline -3

    这条命令用于快速确认最近提交的顺序和说明。

    查看刚才那次提交涉及哪些文件:

    git show --stat HEAD

    查看提交的完整内容:

    git show HEAD

    HEAD 表示当前检出位置对应的提交。在通常的分支状态下,它通过当前分支定位到最新提交。

    确认功能提交没有混入 README 后,再把文档作为独立提交:

    git add README.md
    git diff --cached -- README.md
    git commit -m "docs: add usage example"
    git status

    最后的状态应该是干净的。

    同一个文件包含两个意图怎么办

    按路径执行 git add app.txt 会选择这个文件当前的全部变化。但同一个文件也可能同时包含两个不同意图。

    此时可以交互式选择差异块:

    git add --patch app.txt

    Git 会把变化分成若干块,让我们逐块决定是否暂存。没有选中的部分仍留在工作区,不会被删除。

    完成后分别检查:

    git diff --cached -- app.txt
    git diff -- app.txt

    第一条查看已经选入下次提交的变化,第二条查看仍留在工作区的变化。如果一个差异块内部仍然混着两个意图,可以继续拆分差异块,或者先回到编辑器整理内容。

    为什么不把 commit -am 当作默认动作

    git commit -am "message"

    这个写法会在提交前自动暂存所有已跟踪文件的修改和删除,并提交它们执行命令时的当前内容,但不会纳入普通未跟踪文件。

    但问题在于,它也会绕过"选择路径 → 检查暂存差异"这个过程。如果同一个已跟踪文件在暂存后又继续修改,-a 会把后续工作区修改一起纳入提交,可能破坏原本选择好的边界。

    只有当所有已跟踪变化都属于同一意图,并且已经确认过现场时,这个快捷方式才比较合适。

    一次提交前后的稳定检查顺序

    git status --short
      ↓
    git diff
      ↓
    排除不应跟踪的路径,选择本次相关变化
      ↓
    git diff --cached
      ↓
    git commit
      ↓
    git status --short
      ↓
    git log --oneline / git show

    提交之前检查选择,提交之后核对结果。暂存区不是必须机械经过的一个步骤,而是编辑下一次历史记录的地方。

    总结

    一次清晰的提交不是靠一句漂亮的提交说明产生的,而是从检查现场、排除无关文件、选择同一意图的变化开始。status 定位路径,diff 核对内容,暂存区确定边界,log 和 show 则帮助确认最终写入了怎样的历史。

    参考资料:

    • Git 官方资料:Recording Changes to the Repository
    • Git 官方资料:Viewing the Commit History
    • Git 官方文档:git-status
    • Git 官方文档:git-diff
    • Git 官方文档:git-add
    • Git 官方文档:git-commit
    • Git 官方文档:git-log
    • Git 官方文档:git-show
    • Git 官方文档:gitignore
    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    Transformers 5.23.0对导出、音频和专家并行环境有哪些兼容边界?
    Transformers 5.23.0对导出、音频和专家并行环境有哪些兼容边界?

    5.23.0影响范围取决于旧导出对象、音频依赖与专家并行路径,新增模型也有实验和变体限制。

    GitHub Copilot模型停用后会自动替换吗,哪些事情仍需提前确认?
    GitHub Copilot模型停用后会自动替换吗,哪些事情仍需提前确认?

    Copilot停用旧模型不等于自动迁移;区分移除、组织模型启用、工作流切换与个人年订阅例外。

    GitHub Actions重跑失败作业会使用最新代码吗
    GitHub Actions重跑失败作业会使用最新代码吗

    解释已有运行重跑的提交和权限边界,给出确认、失败作业重跑及结果核对命令,区分漏触发事件。

    chat-demo v0.1.1怎么本地运行并理解DeepSeek历史数据边界
    chat-demo v0.1.1怎么本地运行并理解DeepSeek历史数据边界

    chat-demo v0.1.1可以作为静态聊天客户端在本地运行,但模型、搜索、文件和语音能力仍由DeepSeek API提供。源码运行环境为Node.js 22.12及以上、Git与pnpm。Demo版本号不等于应用API版本;这套应用API未单独标版本,默认聊天模型ID是deepseek-flash。

    GitHub Copilot CLI v1.0.111的用量图与上下文比例应该怎样理解
    GitHub Copilot CLI v1.0.111的用量图与上下文比例应该怎样理解

    理解GitHub Copilot CLI v1.0.111的高级请求百分比、用户提示活动图与实际路由模型窗口,区分显示口径和任务状态。

    n8n 2.47.6、2.47.7、2.48.3 Beta、2.48.4 Beta、3.2.2预发布与1.123.96适用哪些安全修复?
    n8n 2.47.6、2.47.7、2.48.3 Beta、2.48.4 Beta、3.2.2预发布与1.123.96适用哪些安全修复?

    按维护分支、利用权限与节点类型对应四项修复,区分正式补丁、Beta和临时缓解的适用边界。

    GitHub合并故障的已缓解、监控与已解决有什么不同
    GitHub合并故障的已缓解、监控与已解决有什么不同

    GitHub合并故障中的“已缓解并监控”和“已解决”不能互换。前者表示影响已经采取措施缓解,仍在观察稳定性;后者是供应商正式结束这场事故的状态。11月13日的Pull Requests合并超时事件先进入监控,随后于北京时间11月14日02:29标记为已解决。

    llama.cpp v1.0.0的网页聊天分组与Markdown编辑适合哪些场景
    llama.cpp v1.0.0的网页聊天分组与Markdown编辑适合哪些场景

    llama.cpp v1.0.0改善聊天组织、长消息编辑和附件预览;界面变化与底层API迁移、缓存及访问边界需要分别理解。

    Postman 12.36.4 更新后仍报错,怎么判断是哪一层的问题
    Postman 12.36.4 更新后仍报错,怎么判断是哪一层的问题

    Postman 12.36.4 更新后仍有异常时,可按应用、API请求和平台服务区分问题范围,避免把补丁版本当作故障原因。

    n8n 2.47.6、2.48.3 Beta与1.123.96适合哪些部署环境?
    n8n 2.47.6、2.48.3 Beta与1.123.96适合哪些部署环境?

    按正式、预发布和1.x维护渠道对应补丁,再结合Redis、Agent端点和Pinecone索引判断适用范围。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。