vscode克隆仓库需本地安装git并配置path；图形界面仅调用git命令，未安装或path错误会导致克隆失败；克隆后须打开子文件夹而非父目录，并按readme安装依赖才能运行。
VSCode 本身不内置 Git 克隆逻辑，git clone 必须在终端里手动执行——图形界面点“克隆仓库”只是快捷入口，底层仍调用你本地的 git 命令；没装 Git 或 PATH 没配对，点再多遍也没用。
git clone 命令必须在 VS Code 集成终端里运行
VS Code 的「源代码管理 → 克隆仓库」菜单项（或 Ctrl+Shift+P 输入 Git: Clone）只是帮你打开一个输入框，真正执行还是靠终端里的 git。如果你之前没装 Git，或安装时没勾选「Add Git to PATH」，那无论怎么点都会卡在“正在克隆…”或直接报错 command not found: git。
确认方式很简单：按 Ctrl + ` 打开集成终端，输入：
git --version
如果返回类似 git version 2.40.1，说明就绪；否则得先装 Git 并确保它进 PATH：
- Windows 用户重装 Git，安装向导中务必选 “Add Git to PATH”
- macOS 用户检查
~/.zshrc是否有export PATH="/opt/homebrew/bin:$PATH"（Homebrew 安装路径） - Linux 用户确认
/usr/bin/git存在，且当前 shell 的$PATH包含该路径
克隆时 URL 和路径选错会导致 .git 不识别
常见现象是：克隆完打开文件夹，左下角没显示分支名，源代码管理面板空空如也——说明 VS Code 根本没把它当 Git 仓库。根本原因通常是路径搞错了。
- 别提前新建同名空文件夹再选它作为目标路径，否则报错
destination path 'xxx' already exists and is not an empty directory - URL 别多粘一个
.git.git，GitHub 页面上复制的 HTTPS 地址是https://github.com/username/repo.git，结尾那个.git是必须的，但不能再加一次 - 私有仓库用 HTTPS 协议时，密码字段必须填 GitHub 的
Personal Access Token，账号密码已停用 - 图形化克隆会要求你选一个「父目录」（比如
~/code），它会在里面自动建~/code/repo-name；克隆完要 打开这个子文件夹，不是你一开始选的父目录
克隆完不能直接点 ▶️ 运行，得看 README 再装依赖
克隆只拉下代码和 .git 文件夹，不装依赖、不编译、不启动服务。右上角那个 ▶️ 是调试器启动按钮，不是“一键运行项目”开关。
- 前端项目（React/Vue）：进终端，先
npm install或yarn install，再npm run dev - Python 项目：可能要先
python -m venv venv，再pip install -r requirements.txt - Go/Java/C# 项目：得找
Makefile、build.gradle或.sln，手动执行构建命令 - 所有项目，第一件事是打开根目录下的
README.md，里面一定写了setup和run步骤
想跳过 Git 安装？用 vscode.dev 下载单个文件
如果你只是临时要某个 config.json 或 src/utils/ 目录，又懒得装 Git，可以走网页路线：登录 GitHub → Fork 项目 → 访问 https://vscode.dev → 「Open Remote Repository」→ 选你的 Fork → 右键文件/文件夹 → 「Download」。
注意这个方法绕过了本地 Git，但代价也很明显：无法切换分支、看不到 commit 历史、不能 push 修改；单个文件超过几十 MB 时下载容易中断；而且 vscode.dev 和 GitHub 都得能直连——国内用户大概率需要稳定网络环境。
