azure devops 新建团队项目时必须手动选择 git 作为版本控制系统,不可依赖默认选项;visual studio 中应通过“克隆”而非“连接到 team foundation server”接入,且源代码管理插件须设为 git。

Visual Studio 里用 Git 管理团队项目,根本不需要“搭建 TFS 服务器”或配置 TFVC;你直接用 Azure DevOps Services(原 VSTS)或自建 Azure DevOps Server(原 TFS),选 Git 仓库类型就行——关键不是“怎么搭”,而是“别误入 TFVC 路径”。
创建团队项目时必须选 Git,不是默认选项
Azure DevOps 新建团队项目,默认仍可能显示“TFVC”为首选(尤其老账号或企业实例),一旦选错,后续无法切换版本控制系统。Git 和 TFVC 是互斥的底层存储模型,不能共存于同一团队项目。
- 进入
dev.azure.com/{org}→ “新建项目” → 在“版本控制”下拉菜单中,**手动选中Git**,不是留空、不是默认、不是点“下一步”跳过 - 项目名称别含空格或特殊字符(如
My Project v2),建议用my-project-v2,避免后期 CLI 或 CI 脚本出错 - 可见性选“私有”即可,除非你真要公开代码;权限模型在 Git 下由 repo 级权限 + 分支策略控制,和 TFVC 的集合级权限体系完全不同
Visual Studio 2019/2022 连接 Git 项目不要点“连接到 Team Foundation Server”
这个菜单项是历史遗留,专为 TFVC 设计。点它会弹出 TFVC 连接向导,强行走工作区映射流程,和 Git 的本地克隆逻辑冲突,导致“找不到工作区”或“源代码管理器空白”。
监控一个或多个 GitCode 仓库的 PR,通过 OpenClaw Gateway 自动执行 AI 审查,发布 PR 评论,并发送钉钉和企业微信通知。
- 正确路径:启动 VS → 欢迎界面点
克隆→ 粘贴 Azure DevOps 里该项目的Clone URL(格式类似https://dev.azure.com/{org}/{project}/_git/{repo}) - 如果已打开解决方案,用
团队资源管理器→ 顶部“管理连接”→ 点击“克隆”图标(不是“连接到项目”) - 首次克隆后,VS 自动识别 .git 目录,底部状态栏显示分支名(如
main)和“未推送提交”数,这才是 Git 工作流正常信号
签入代码前先确认 Git 设置没被 TFVC 插件污染
装过 Team Explorer 或旧版 TFS 插件的机器,可能残留 tf.exe 注册或全局 Git 配置被篡改,导致 VS 里右键菜单出现“添加到源代码管理”(TFVC 动作)而非“暂存更改”(Git 动作)。
- 检查 VS 设置:
工具 → 选项 → 源代码管理 → 当前源代码管理插件,必须是Git,不是Team Foundation Version Control - 终端验证:
git config --global core.autocrlf应返回true(Windows)或input(macOS/Linux);若返回错误或为空,说明 Git 基础环境未就绪 - 删掉残留 TFVC 映射:打开
团队资源管理器 → 源代码管理器 → 右上角齿轮图标 → 取消所有“工作区”映射,TFVC 工作区和 Git 本地仓库混用会锁死文件状态
真正容易卡住的地方,是以为“连上 Azure DevOps 就算 Git 搭好了”——其实只要没在新建项目时勾选 Git,或者 VS 里没走克隆流程而是点了“连接到 Team Foundation Server”,整个流程就自动降级到 TFVC 模式,后续所有 Git 操作都会静默失败或报 TF401019 类错误。盯住那两个下拉菜单和那个克隆按钮,比调任何配置都管用。










