Visual Studio 开发项目必须选择 Git 或 TFVC 之一,二者不可混用;顶部状态栏显示当前类型,Git 支持分支图谱与 Pull/Push 流程,TFVC 依赖显式工作区映射且不支持跨盘符或含空格路径,切换版本控制类型无内置迁移功能。

Visual Studio 开发项目必须明确选择版本控制系统,Git 和 TFVC 是唯二原生支持的选项;选错或混用会导致团队协作中断、历史丢失或权限异常。
确认当前项目用的是 Git 还是 TFVC
打开“团队资源管理器”(查看 > 团队资源管理器),顶部状态栏会直接显示当前连接的源代码控制类型。如果显示 Git,说明使用的是分布式 Git 仓库;若显示 TFVC,则为集中式 Team Foundation 版本控制。两者不可互换:Git 仓库不能直接执行 tf.exe 命令,TFVC 项目也无法在“同步”页看到分支图谱。
常见错误现象:
- 克隆 GitHub 仓库后,“团队资源管理器”里看不到“同步”页,只显示“连接”——大概率是项目根目录没识别到
.git文件夹,需手动点击“管理连接” > “添加 Git 存储库” - 右键文件出现“高级” > “添加到源代码管理”,但点击无反应——该操作仅对 TFVC 有效,Git 下应通过“源代码管理”视图的 + 号暂存文件
Git 工作流中必须先 Pull 再 Push
多人协作时,直接 Push 很可能被远程拒绝(rejected - non-fast-forward)。VS 2022 的“同步”页强制你先拉取,本质是执行 git pull --rebase(默认行为),避免生成无意义的 merge commit。
实操建议:
Visual Studio 18.8.1 官方固定版本安装引导程序,当前条目使用微软发布历史中的 Professional Web Installer,适合旧项目兼容、环境回退、复现特定构建链和排查版本差异等场景。
- 每次开始编码前,先点“拉取”;提交前再拉一次,确保本地 HEAD 与
origin/main一致 - 若拉取后出现冲突,VS 会自动打开“合并冲突”工具,**不要跳过解决直接点“接受传入更改”**——这会丢弃你本地所有未暂存修改
- 想跳过 rebase 改用 merge,需在命令行执行
git config --global pull.rebase false,VS 界面不提供开关
TFVC 中工作区映射必须显式设置
TFVC 不像 Git 那样自动关联本地路径,所有文件操作都依赖“工作区”(Workspace)映射。未映射的文件即使在解决方案中,也无法签出、检入或查看历史。
关键步骤:
- 首次连接 TFVC 项目后,必须打开“源代码管理资源管理器”,右键根节点选择“高级” > “工作区” > “新建工作区”
- 映射路径不能跨盘符(如
C:\src映射到D:\work会失败),且本地路径不能包含中文或空格(否则tf.exe报错TF208041: The path contains invalid characters) - 映射类型选“服务器”而非“本地”——后者仅用于离线编辑,无法参与团队协同
切换版本控制类型不可逆
VS 不提供从 TFVC 切换到 Git 或反之的内置迁移功能。强行删除 .tf 或 .git 文件夹,会导致“团队资源管理器”失去上下文,甚至让已加载项目变灰不可用。
真实场景中容易被忽略的点:
- 新建项目时,向导里的“源代码管理”复选框只影响初始 .sln 文件是否加入版本控制,**不决定底层系统类型**;TFVC 项目仍需手动映射,Git 项目仍需初始化仓库
- 通过“克隆”获取的 Git 项目,其分支信息存储在
.git/refs/remotes/origin/,而 VS 的“分支”页只显示本地分支(git branch输出),远程分支需手动 Fetch 才可见 - TFVC 的“批注”功能(Annotate)能精确到行级变更集,但 Git 的“Blame”在 VS 中不显示提交者邮箱,只显示用户名——若团队用企业 AD 账号登录 Azure DevOps,邮箱字段为空,需靠
git blame -e命令补全

















