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 的本地克隆逻辑冲突，导致“找不到工作区”或“源代码管理器空白”。
Git Changelog Generator
下载
使用约定式提交（Conventional Commits）从 Git 历史记录中生成结构化变更日志，支持多种格式、AI 增强型描述以及可自定义的范围……
- 正确路径：启动 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 类错误。盯住那两个下拉菜单和那个克隆按钮，比调任何配置都管用。
