Git 技巧：如何将当前未提交代码新建为功能分支

前言

在日常开发中，我们经常会遇到这样的尴尬场景：在 main 或 develop 分支上写了一大段代码，突然意识到这些改动应该属于一个新的功能分支。

很多开发者此时的第一反应是 git stash → 切分支 → git stash pop，或者更糟糕的是直接提交到错误分支再想办法回退。其实，Git 提供了更安全、更优雅的原生解决方案。本文将介绍如何一步到位地将未提交代码迁移到新分支。

✅ 核心方案：git switch -c

💡 关键认知：Git 在创建新分支时，会自动携带工作区和暂存区的所有修改，不会丢失任何未提交的代码。因此，完全不需要先 stash 再切分支。

操作步骤

# 1. 基于当前分支创建并切换到新功能分支（未提交代码自动跟随）
git switch -c feature/your-feature-name

# 2. 确认代码已在新分支上
git status

# 3. 正常提交代码
git add .
git commit -m "feat: 描述你的功能变更"

📌 版本说明：git switch -c 是 Git 2.23+ 引入的新命令，语义比旧版的 git checkout -b 更清晰。如果你的 Git 版本较老，使用 git checkout -b feature/your-feature-name 效果完全相同。

⚠️ 常见误区与注意事项

在实际操作中，以下几个场景需要特别注意：

场景	正确做法	说明
❌ 先 stash 再切分支	直接 switch -c	多此一举，创建分支本身就会保留未提交修改
目标分支名已存在	git switch feature/xxx	去掉 -c 参数，直接切换到已有分支即可
想基于特定提交建分支	git switch -c feature/xxx <commit-hash>	指定起点提交，而非当前 HEAD
已在错误分支提交了代码	git reset --soft HEAD~1	撤回提交但保留所有修改，再切到新分支重新提交

🔑 误操作补救详解

如果你已经不小心在错误的分支上执行了 git commit，不要慌：

# 软重置：撤销最近一次提交，但保留所有文件修改在工作区
git reset --soft HEAD~1

# 此时修改仍在，再按正常流程创建新分支
git switch -c feature/your-feature-name
git commit -m "feat: 正确的提交信息"

⚠️ 注意：这里必须用 --soft，如果用 --hard 会导致代码丢失！

🔍 验证结果

操作完成后，建议通过以下命令确认一切正确：

# 确认当前所在分支
git branch --show-current

# 查看最近的提交历史是否符合预期
git log --oneline -3