需先本地初始化仓库并关联gitee远程地址：git init → git add . → git commit → git remote add origin → git push -u origin main；注意分支匹配、ssh/https权限及推送前拉取同步。
确认本地 Git 已配置且仓库已初始化
码云（gitee）本身不参与提交逻辑，它只是远程 Git 仓库；真正要做的，是把本地 Git 仓库推到 Gitee 的对应地址。如果 git status 报错 “not a git repository”，说明还没初始化——这不是码云的问题，是本地没建仓。
- 进项目根目录，运行
git init - 用
git add .暂存文件（注意点号别漏） - 用
git commit -m "first commit"提交到本地库 - 检查
git remote get-url origin是否为空，空就说明还没连远端
添加 Gitee 远程仓库地址（SSH 或 HTTPS）
VS Code 只是编辑器，它调用的是你系统里装的 Git 命令行工具。远程地址填错、权限不对，VS Code 的“推送”按钮点十次也没用。
- 去 Gitee 新建空仓库，**不要勾选「初始化 README」**——否则会冲突，得先拉再改再推
- 复制页面上的 SSH 地址（形如
git@gitee.com:username/repo.git）或 HTTPS 地址（https://gitee.com/username/repo.git） - 在终端执行：
git remote add origin https://gitee.com/username/repo.git（替换为你自己的地址） - HTTPS 方式需输账号密码（或个人访问令牌），SSH 方式需提前配好密钥，否则
git push会卡住或报Permission denied (publickey)
VS Code 内推送前务必检查分支与上游关联
VS Code 左下角显示的分支名（比如 main）只是当前检出分支，不代表它已经和 Gitee 上的同名分支绑定了。没绑定时点“推送”，VS Code 默认只推提交，不自动建远程分支，也不设 upstream，下次还得手动指定。
- 终端运行
git branch -vv，看当前分支后面有没有[origin/main]这样的标记 - 如果没有，执行：
git push -u origin main（把main换成你实际的分支名，比如master） -
-u参数关键：它把本地分支和远程分支“记下来”，之后直接点 VS Code 的推送图标才有效 - 如果 Gitee 仓库默认分支是
master，但本地是main，别硬推，先git branch -M master改名，避免后续混乱
遇到 “rejected — non-fast-forward” 或 “failed to push” 怎么办
这类错误不是网络问题，几乎全是本地和远程历史不一致导致的。VS Code 弹窗只写“推送失败”，但真正原因得看终端输出。
- 常见诱因：Gitee 上有别人（或你自己其他机器）先推了提交，而你本地没拉最新；或者你强制重写了历史（
git rebase/git commit --amend）后直接推 - 安全做法是先
git pull origin main --rebase（或--ff-only），解决冲突后再推 - 千万别轻易用
git push --force，尤其团队协作中——它会抹掉别人已推的提交 - 如果只是自己单机用、且确定远程内容可丢，可用
git push --force-with-lease，比裸 –force 多一层保护
Gitee 的仓库地址、SSH 密钥、分支命名习惯（master 还是 main）、是否启用了两步验证——这些细节不显眼，但任何一个没对上，VS Code 就会安静地失败。