使用 VS Code 将本地项目上传至 Gitee 仓库指南

git init

步骤 3：添加文件并提交

1. 在 VS Code 左侧活动栏点击 源代码管理（Source Control） 图标（或按 Ctrl+Shift+G）。
2. 建议先创建 .gitignore 文件，把不需要上传的环境、静态资源等文件排除。
3. 你会看到所有未跟踪的文件列在 'Changes（更改）' 区域。
4. 点击文件旁边的 + 图标（或点击顶部的 + 全选）将文件暂存（Stage）。
5. 在输入框中填写提交信息（如 首次提交），然后按 Ctrl+Enter 提交。

你也可以在终端中执行：

git add .
git commit -m "首次提交"

步骤 4：关联远程 Gitee 仓库

方法 1：使用 SSH 地址通过界面关联

在 Gitee 找到 SSH 地址，粘贴地址，点击回车，再输入一个仓库名字，接着点击发布即可。

方法 2：在终端中执行

替换为你的实际仓库地址：

git remote add origin https://gitee.com/yourname/my-project.git

验证是否添加成功：

git remote -v

应显示：

origin https://gitee.com/yourname/my-project.git (fetch)
origin https://gitee.com/yourname/my-project.git (push)

步骤 5：推送代码到 Gitee

执行推送命令：

git push -u origin main

注意：Gitee 默认分支名可能是 master 或 main，取决于创建仓库时的设置。 如果提示 src refspec main does not match any，尝试查看本地分支名或修改为 master。

首次推送时，VS Code 或系统可能会弹出认证窗口，输入你的 Gitee 账号和密码。（手机号和密码）

⚠️ 重要：自 2021 年起，Gitee（以及 GitHub）不再支持账号密码直接认证。你需要使用 个人访问令牌（Personal Access Token） 代替密码。

如何生成 Gitee 个人访问令牌？

1. 登录 Gitee，进入 设置 → 私人令牌（Private Token）。
2. 点击 '生成新令牌'，填写令牌名称（如 vscode-push），勾选 repo 权限。
3. 点击 '生成'，复制生成的令牌（只显示一次，请妥善保存）。
4. 推送时，用户名填 Gitee 用户名，密码填该令牌。

五、补充问题：处理 .gitignore 遗漏

由于是首次操作，我们可能会忘记创建 .gitignore 文件，或者在上传代码后才发现 .gitignore 文件存在遗漏，导致远程仓库中出现许多不必要的文件。在补充完 .gitignore 文件后，我们需要重新移除对这些文件的跟踪，以确保后续这些被忽略的文件不会上传到远程仓库。

这里因为我们是首次上传进仓库，且是单独开发，所以可以直接全部移除，再重新添加：

git rm -r --cached .
git add .

这表示先取消所有文件的缓存（但保留本地文件），再重新 add，此时 .gitignore 生效，被忽略的文件就不会被加入暂存区。

直接运行提交命令：

git commit -m "移除无用文件，新建 .gitignore"

强制推送：

git push --force origin main # 或者你用的是 master 分支：git push --force origin master

六、总结

通过 VS Code 与 Gitee 的结合，开发者可以高效地进行本地开发与远程协作。整个流程核心在于：

1. 初始化本地 Git 仓库；
2. 创建 Gitee 远程仓库；
3. 关联远程地址；
4. 使用个人访问令牌安全认证；
5. 推送代码。

掌握这一流程后，你不仅能上传新项目，还能轻松管理日常的版本控制与团队协作。