能直接推送需满足三前提：本地已git init初始化、远程仓库为空（未勾选readme初始化）、git remote add origin配置正确；缺一则push报错或失败。
能直接推，但必须满足三个前提：本地项目已初始化为 Git 仓库、远程仓库为空、git remote add origin 配置正确。缺一不可，否则会卡在 git push 报错或覆盖失败。
本地没初始化 .git？先 git init
VS Code 左侧点「源代码管理」图标，如果显示“初始化仓库”按钮，说明还没初始化；点它就等价于在终端执行 git init。别跳过这步——没有 .git 文件夹，VS Code 就不会识别为 Git 项目，后续所有提交、推送操作都无效。
常见错误现象：
- 点「暂存更改」没反应，或提示“未找到 Git 仓库”
- 终端里运行
git status报错 “not a git repository”
注意：git init 只需执行一次，且必须在项目根目录下运行（即你用 VS Code 打开的那个文件夹）。
远程仓库不能带 README？否则 git push 会拒绝
Gitee 或 GitHub 新建仓库时，如果勾选了「使用 README 初始化」，远程仓库就有了第一次提交，而你的本地仓库是空的，两者历史不相关。这时直接 git push origin main 会被拒绝，报错类似：
error: failed to push some refs to 'https://gitee.com/xxx/yyy.git' hint: Updates were rejected because the remote contains work you do not have locally.
解决方法只有两个：
- 新建远程仓库时，**一定不要勾选 README 初始化选项**（Gitee 叫“使用 README.md 初始化”，GitHub 叫“Initialize this repository with a README”）
- 如果已经误建，只能删掉远程仓库重来，或改用
git pull origin main --allow-unrelated-histories合并（不推荐新手用，容易混入冲突）
SSH 连不上 Gitee？检查 ssh -T git@gitee.com 结果
点击 VS Code 的「发布分支」后卡住，或终端报 Permission denied (publickey)，说明 SSH 密钥没配好。这不是 VS Code 的问题，是 Git 认证层失败。
验证方式很简单：在 VS Code 内置终端（选 Git Bash）运行：
ssh -T git@gitee.com
如果返回 Welcome to Gitee.com, xxx!，说明密钥已生效；如果仍报 Permission denied，就得重新生成密钥并添加到 Gitee 账户：
- 运行
ssh-keygen -t ed25519 -C "your_email@gitee.com"，连按三次回车（不设密码） - 把生成的
~/.ssh/id_ed25519.pub全文复制，粘贴进 Gitee 账户设置 → SSH 公钥 - 再次运行
ssh -T git@gitee.com确认成功
注意：用 HTTPS 地址（https://gitee.com/xxx/yyy.git）可绕过 SSH，但每次 push 都要输账号密码；用 SSH（git@gitee.com:xxx/yyy.git）更省事，但必须配密钥。
git push -u origin main 还是 master？看远程默认分支名
Gitee 新建仓库默认分支是 main，GitHub 也是；但老项目或手动改过可能还是 master。推送前先确认远程分支名：
- 打开 Gitee 仓库主页，看右上角当前分支名（比如写着「main」或「master」）
- 或者终端运行
git ls-remote --heads origin，看返回的第一行是refs/heads/main还是refs/heads/master
然后对应执行：
git push -u origin main
或
git push -u origin master
如果推错了分支名，会提示 “failed to push some refs”，此时别硬加 --force，先查清远程真实分支再重试。
最容易被忽略的是 .gitignore —— 不加它，node_modules、.vscode、dist 全部会被提交，不仅拉慢推送速度，还污染仓库历史。初始化后、第一次 git add . 前，务必先手写一个 .gitignore 文件。
