git add -p 是 Git 交互式分块暂存命令，将文件修改按逻辑块（hunk）拆分并逐个询问是否暂存；适用于单文件中需分批提交（如仅提交 bug 修复而保留调试日志）、精准控制补丁内容等场景。
git add -p 是什么，适合什么场景
git add -p 是 Git 提供的交互式补丁暂存命令，它不把整个文件加进暂存区，而是把每个「逻辑上独立的修改块」（hunk）拆开，逐个问你是否要暂存。适合你改了一个文件但只想提交其中几处、其余改动还要留着继续调试或等后续 PR 的情况。
典型场景包括：修复一个 bug 时顺手调了日志格式，但日志改动不想进这次 commit；或者在重构函数时保留部分实验性代码，只把已验证的变更提交。
执行 git add -p 后怎么选操作
运行 git add -p 后，Git 会逐块显示修改，并提示类似 Stage this hunk [y,n,q,a,d,s,e,?]? 的选项。关键选项含义如下：
-
y：暂存当前块（yes） -
n：跳过当前块（no），保留在工作区 -
s：把当前块再拆得更细（split），比如一个函数里有两处改动，s可能把它分成两个独立 hunk -
e：手动编辑当前 hunk（edit），可删行、改行，甚至只留一行 —— 这是精确控制的最强方式 -
q：退出，不处理剩余块
注意：a（全部暂存）和 d（全部跳过）作用于「当前文件剩余所有块」，不是全局；误按容易漏掉想暂存的内容。
常见错误：为什么 git add -p 没反应或报错
最常遇到的是以下三种情况：
- 当前文件没有未暂存的修改（即
git status显示为 “nothing to commit” 或 “all changes staged for commit”），git add -p会直接退出，不报错也不提示 - 修改跨多行但被 Git 认为“不够独立”，导致无法 split（
s无效），此时只能用e手动删减 - 使用了中文路径或含空格的文件名，某些旧版 Git 会卡在交互界面，建议先用
git add -p -- <code>显式指定文件名避免解析歧义
另外，git add -p 不支持暂存新创建的空文件（untracked empty file），这类文件必须先 git add 再改内容，才能进入 -p 流程。
和 git add -i 的区别在哪
git add -i 是交互式暂存主菜单，功能更广但粒度粗；git add -p 是其中「patch」子模式的快捷入口，专注代码块级控制。
二者核心差异：
-
git add -i可以批量选文件、撤销暂存、查看 diff，但对单个文件内部修改无法精细拆分 -
git add -p默认只处理已跟踪文件的未暂存修改，不处理新增文件（untracked），也不支持直接撤销已暂存内容 - 如果需要先挑文件、再挑块，推荐组合使用：
git add -i→ 选5（patch）→ 再进具体文件
真正容易被忽略的是：一旦用 e 编辑过 hunk，Git 就不再校验该块的上下文行是否匹配原始 diff，这意味着你手动删掉几行后，git diff --cached 可能看起来“不连贯”，但 commit 仍能成功 —— 这既是灵活性来源，也是出问题时难定位的原因。
