克隆前必须确认Git功能已启用、远程URL可访问、凭据匹配目标服务；VS使用Windows凭据管理器或Microsoft Entra账号认证，而非本地Git配置或浏览器登录凭据。
克隆前必须确认的三件事
Visual Studio 克隆失败，80% 是卡在这三步没做对：Git 功能已启用、远程 URL 可访问、凭据匹配目标服务。不是“点一下就完事”，而是 IDE 在后台调用 git clone，但会绕过你本地 Git 配置，改用 Windows 凭据管理器或 Microsoft Entra（原 Azure AD）账号。
- 检查
工具 > 选项 > 源代码管理 > Git 全局设置中是否启用了 Git 插件（不是 TFVC） - HTTPS URL 必须带完整协议，例如
https://github.com/user/repo.git，不能漏掉.git后缀（部分私有 Git 服务要求） - 若用自建 Git 或 Azure DevOps，浏览器能登录 ≠ VS 能登录——VS 默认尝试用当前 Windows 登录账号去认证，和你在网页输的账号密码无关
克隆时选错路径导致项目打不开
VS 的“克隆存储库”对话框里填的 Path，不是“父目录”，而是**项目根目录本身**。填错会导致 .sln 文件被埋进子文件夹，VS 找不到解决方案。
- 正确做法：指定一个空文件夹，比如
C:\dev\myproject，不要填C:\dev然后指望 VS 自动建myproject子目录 - 如果误填了父目录，克隆后打开
解决方案资源管理器看不到任何项目，要手动双击文件夹里的.sln文件；或者删掉整个文件夹重来 - 克隆完成后，VS 不会自动加载
.sln，除非你提前在设置 > 源代码管理 > Git 全局设置中勾选了“打开 Git 存储库时自动加载解决方案”
私有仓库认证失败：TF30063 不是权限问题，是身份错配
TF30063: 您没有访问 https://git.example.com/ 的权限 这个错误最常被误解。它不表示你没被授权，而是 VS 尝试用 Windows 账号（或微软账号）去连一个需要 PAT（个人访问令牌）或 Microsoft Entra 凭据的 Git 服务。
- GitHub 私有库：必须用 GitHub 账号登录 VS（
Git > 克隆存储库 > 从 GitHub 打开），不能直接粘贴 HTTPS URL - Azure DevOps / 自建 Git：浏览器登录用的是组织账号，VS 默认走 Windows 凭据管理器 → 去
Windows 设置 > 账户 > 登录选项 > Windows 凭据删除所有git:https://...条目，再重新克隆，此时会弹出登录框让你输 PAT 或 Entra 账号 - SSH 方式虽可绕过凭据问题，但 VS 对 SSH 支持不稳定，尤其 Windows 上需额外配置
ssh-agent和GIT_SSH_COMMAND环境变量，不推荐新手用
克隆后看不到 Python 项目或 .py 文件？检查工作负载和文件夹视图
克隆完成只是把代码拉下来，不代表 VS 知道这是 Python 项目。Python 工作负载未安装、或没切换到文件夹视图，都会让 .py 文件不显示或无法调试。
- 确认已安装 Python 工作负载：启动器里点“修改” → 勾选
Python 开发（不是“Python 语言支持”扩展） - 默认打开的是“解决方案视图”，但很多 Python 项目没有
.sln文件 → 点击解决方案资源管理器顶部的切换视图按钮，换成“文件夹视图” - 如果仍不显示
.py文件，右键文件夹 →在文件资源管理器中打开文件夹，确认文件真实存在；不存在说明克隆的是空分支或非 master/main 分支，需手动Git > 分支 > 检出切换
