PhpStorm无法直接提取“部分代码”到新分支，因分支是提交快照指针而非代码容器；正确做法是：先隔离目标代码（注释/暂存/删除无关改动），再创建并检出新分支，最后验证清理。
PhpStorm 不能直接把“部分代码”提取到新分支——分支是 Git 的提交快照指针，不是容器，也不绑定文件或代码块。所谓“提取代码到分支”，本质是：先在当前分支上隔离出目标代码（删、注释、移动或暂存），再基于该状态新建并检出分支。操作错位会导致丢失改动或污染主干。
为什么“选中代码 → 提取到分支”菜单根本不存在
Git 分支管理的是整个工作区的提交历史，不是编辑器里高亮的几行。PhpStorm 的 Git 集成严格遵循 Git 语义：分支切换、创建、推送都作用于 HEAD 和暂存区（index），不识别“逻辑代码块”。试图找“Extract to Branch”选项只会浪费时间。
- 所有“分支相关重构”实际是本地工作流组合：修改代码 →
git add部分文件/行 →git commit→git checkout -b new-branch - PhpStorm 的
Refactor菜单里只有Move、Extract Method、Extract Class等代码结构操作，没有分支级提取功能 - 右键菜单或
Ctrl+Alt+Shift+T弹出的重构列表里，搜branch或extract都不会出现分支操作项
真正可行的三步法：从改代码到推新分支
想让某段功能只出现在新分支（比如 feat/payment-v2），必须手动控制其可见性，再固化为新分支起点：
-
先隔离代码：在当前分支（如
main）中，把目标逻辑以外的代码临时注释掉，或剪切到剪贴板；确保git status显示只有你要保留的改动（或用git add -p交互式暂存） -
再创建并检出分支：点击右下角 Git widget →
New Branch→ 输入名（如feat/payment-v2）→ 勾选Checkout branch→ 点击 OK。此时新分支以你刚暂存的状态为起点 -
最后清理与验证：在新分支上运行测试，确认功能完整；回到原分支，用
git restore .撤销临时注释/剪切；避免误提交到main
想只同步某几个文件？别用 merge，用 cherry-pick
如果已在 main 上提交了 A、B、C 三个文件，但只想把 B 文件的改动带到 test 分支，git merge main 会带入全部——这时必须用 cherry-pick：
立即学习“PHP免费学习笔记（深入）”；
- 切换到
test分支：git checkout test - 打开 Git Log（
Alt+9→Log标签页），切换到main分支视图 - 找到包含 B 文件改动的那个
commit，右键 →Cherry-Pick - PhpStorm 会自动应用该次提交的变更（仅限 B 文件），不会碰 A、C
注意：cherry-pick 后的提交 ID 会变，它生成的是新提交，不是原提交的复制。
容易被忽略的坑：未暂存的修改会卡住分支切换
当你在 main 上改了代码但没 add 或 commit，直接点 “New Branch” 创建 feat/x，PhpStorm 默认走 Smart Checkout：它会把未提交改动 shelve，切完再 unshelve——结果这些改动会一起带到新分支，而非“只提取目标代码”。
要避免这点，必须在创建分支前：要么 git add 你想要的改动（其余 git restore），要么手动 git stash 掉不需要的改动，再创建分支。否则，“提取”出来的根本不是你想要的子集。
