在 visual studio 中安全创建并切换新分支需三步：先通过 git > 新分支打开对话框，确保“基于”选对源分支（如 origin/develop）以建立远程追踪关系，勾选“结帐分支”才能自动切换；分支名禁用首尾斜杠（如 /feat/login）；删除分支时注意右键才显示的“同时删除远程分支”选项，避免误删。

Visual Studio 的 Git 分支管理不是“点点就完事”，关键在于理解操作背后的状态变化，否则容易误删、丢提交或推送失败。

怎么安全创建并切换新分支

在 Visual Studio 中，点击菜单栏 Git > 新分支 是最直接的方式。但要注意三点：

• “基于”下拉框默认选中当前分支，但如果想从某个远程分支（如 origin/develop）拉出新分支，必须手动切换选择——否则新建的只是本地快照，不带远程追踪关系
• 勾选“结帐分支”才会自动切换；若没勾选，分支已建好但你仍在原分支工作，容易误提交
• 分支名里避免用 / 开头或结尾（如 /feat/login），VS 会报错 fatal: 'feat/login' is not a valid branch name

为什么“Squash 提交”后推送失败

VS 的“Squash 提交”本质是交互式变基（git rebase -i），会重写提交历史。一旦你已把原始提交推送到远程，再 squash 后直接推送就会被拒绝，报错 non-fast-forward update。

Convert Github Repository

适用于以下场景：（1）用户提供 GitHub 仓库 URL 或本地仓库路径，并请求将其转换为其他格式；（2）用户请求导出 GitHub 仓库……

下载

• 如果还没推过，squash 后点 推送 按钮即可
• 如果已推送过，必须勾选 启用推送 --force-with-lease（路径：工具 > 选项 > 所有设置 > 源代码管理 > Git 设置），否则 VS 不给你强制推送选项
• 切勿对多人共用的分支（如 main）做 squash + force push，这会破坏他人本地历史

如何在不切换分支的前提下查看另一个分支的代码

很多人习惯先 checkout 再看，其实完全没必要——VS 支持纯浏览模式：

• 打开 Git 存储库 窗口（Ctrl+0, Ctrl+R），左侧选 Branches / Tags
• 右键任意远程分支（如 origin/feature/payment）→ 选 在新标签页中打开
• 此时编辑器显示的是该分支最新提交的文件快照，且底部状态栏仍显示你当前所在分支名，不会影响你的工作区
• 这个操作等价于命令行的 git show origin/feature/payment:src/App.tsx，但更直观

推送时提示“1 个传出 / 0 个传入”却推不动

这个提示只说明“有未推送的提交”，不代表能成功推送。常见卡点：

• 本地分支没设置上游（upstream）：右键分支 → 设置为上游分支，选对应远程分支（如 origin/feature/login）
• 远程分支名和本地不一致（比如远程叫 dev，你本地叫 develop）：VS 不会自动映射，必须手动指定上游
• 远程仓库权限不足（尤其 Azure DevOps 或私有 GitLab）：VS 不会弹明确错误，只卡在“正在推送…”，此时需检查输出窗口的 Git 面板日志，找 403 Forbidden 或 authentication failed

分支操作真正危险的不是按钮多，而是 VS 把 git 的底层状态封装太深——比如“删除分支”按钮既删本地也删远程（如果勾了“同时删除远程分支”），而这个勾选项默认是隐藏的，要右键才出现。稍不注意，就删掉了别人正在开发的分支。