git add -p 是什么

git add -p 把文件的改动拆成一个个补丁块，逐块询问是否加入暂存区。它解决的是「一个文件里混着几件不同的事」这个问题：可以只把其中一部分放进这次提交，剩下的留到下一次。按补丁块提交是保持提交粒度的重要手段。

交互时的按键

每个补丁块都会给出提示，常用回答有 y 表示暂存这块、n 表示跳过、s 表示把大块拆成更小的块、e 表示手工编辑补丁、q 表示退出、问号查看帮助。不熟悉时先输入问号看一遍说明，比凭记忆猜按键含义稳妥得多。

基本信息

典型使用场景

• 拆分提交：一个文件里同时含新功能与格式调整，分开提交
• 剔除调试代码：提交业务改动时跳过临时打印语句
• 精细评审：让每条提交只承载一类改动，便于回溯
• 留住误改：把顺手改到但不想提交的部分保留在工作区
• 大文件重构：配合 s 拆小补丁块，做出语义单一的提交

常用示例

git add -p                       # 逐块选择要暂存的改动
git add -p src/main.go           # 限定到某个文件
git add -e file.txt              # 手工编辑补丁后再入库
git add -N newfile.py            # 新文件先登记才能进入交互选择
git add -p && git diff --staged  # 选完立刻复核即将提交的内容

常用交互键