克隆仓库前必须确认三件事：本地已安装并配置好Git（git version和git config --list验证）、仓库地址完整且有访问权限、HTTPS用PAT或SSH配密钥；之后再通过界面或命令行克隆，完成后先git pull同步最新代码。
克隆仓库前必须确认的三件事
VS Code 本身不自带 Git，拉取代码的前提是本地已装好 Git 并被 VS Code 正确识别。打开终端执行 git version 能看到版本号才算过关；如果报错“command not found”，说明 Git 没装或没进 PATH，VS Code 就完全用不了 Git 功能。
另外两个关键点：仓库地址要完整（https:// 或 git@ 开头），且你有对应权限。比如公司内网 Git 地址 http://60.217**/xinyuai/ldrs，少一个斜杠、漏掉端口、或没登录账号，都会卡在“Authentication failed”或“Repository not found”。
- 检查 Git 是否就绪：
git config --list应至少显示user.name和user.email - HTTPS 地址拉取会弹窗要密码——若用的是个人访问令牌（PAT），得填令牌而非登录密码（GitHub 已禁用账户密码）
- SSH 地址（如
git@github.com:user/repo.git）需提前配好密钥，否则直接报Permission denied (publickey)
两种拉取方式：界面点选 vs 命令行克隆
VS Code 提供了两种等效路径，选哪个取决于你手边有没有现成文件夹、要不要控制克隆位置，以及是否习惯看终端反馈。
界面操作更直观：点击左侧「源代码管理」图标 → 「克隆仓库」→ 粘贴地址 → 选本地路径 → 点击「打开」。VS Code 会自动在该路径下建同名文件夹并克隆进去。适合新手或临时想试个项目。
命令行更可控：先 mkdir -p ~/projects/myapp 创建空目录，再 cd ~/projects/myapp，最后运行 git clone <url> .</url>（注意末尾的 .）。这样代码会直接落在当前目录，而不是多套一层子文件夹。多人协作时，团队常约定这种扁平结构，避免路径嵌套过深。
- 用
git clone <url></url>（无.）会在当前目录新建repo-name文件夹 - 用
git clone <url> .</url>（带.）把代码直接解压到当前空目录，适合已有项目结构或需要精确控制路径的场景 - 克隆中途断网？删掉半成品目录再重试，别手抖
git pull—— 那是给已有仓库用的，对空目录无效
拉完代码打不开？检查 VS Code 是否识别为 Git 仓库
克隆完成后，用 code . 在终端中打开当前目录，或用 VS Code 的「文件 → 打开文件夹」选中该目录。如果左下角状态栏没显示分支名（如 main）、源代码管理面板里一片空白，说明 VS Code 没检测到 .git 目录。
常见原因有两个：一是克隆失败只下载了部分文件，.git 根本没生成；二是你误开了父级目录（比如克隆到了 ~/projects/ldrs，却打开了 ~/projects）。这时终端里执行 ls -la，确认目录下存在 .git 隐藏文件夹是最准的判断方式。
- 正常克隆后，
git status应返回On branch main和一堆nothing to commit - VS Code 左侧「源代码管理」面板顶部若显示 “No source control providers are registered”，说明 Git 插件未启用或 Git 路径配置错误
- 右下角分支名点一下，能列出
origin/main说明远程连接成功；如果只显示本地分支、没有origin，可能是克隆时网络中断导致 remote 未设置
第一次拉取后，千万别跳过这一步：同步最新变更
刚克隆下来的代码只是快照，不是活的。尤其多人协作项目，别人可能已在你拉取后又提交了新内容。所以打开项目第一件事，不是改代码，而是先 git pull —— 这步在 VS Code 里点状态栏分支名 → 「Pull」就行。
跳过它直接改、提交、推送，极大概率触发拒绝（rejected, non-fast-forward），因为你的本地历史和远程对不上。VS Code 不会自动帮你做这个同步，它只管“你点了才动”。很多新人卡在这儿，以为推送失败是权限问题，其实是本地落后了两三个 commit。
- VS Code 终端里执行
git log --oneline -n 5，对比git ls-remote origin -h refs/heads/main | cut -f1返回的最新 commit ID，能快速看出是否落后 - 如果
git pull报 conflict，说明别人改了你正准备动的同一行——这是协作常态，VS Code 会高亮冲突块，点「Accept Current Change」或「Accept Incoming Change」就能选 - 记牢四字口诀：添、提、拉、推。拉（pull）永远在提（commit）和推（push）之前，顺序错了就得手动 merge 或 rebase
git pull 里。很多人忽略这点，直到推送被拒才回头查日志——其实只要养成打开项目先看一眼状态栏分支旁有没有 ↑↓ 符号的习惯，就能避开大半麻烦。 
