使用 VS Code 将项目代码上传到 Gitee 的完整指南
在现代软件开发流程中，版本控制是不可或缺的一环。
Gitee（码云）作为国内领先的代码托管平台，为开发者提供了稳定、快速的 Git 服务。
本文将详细介绍如何使用 Visual Studio Code（VS Code）将本地项目代码上传至 Gitee 仓库，涵盖从环境配置、初始化仓库到推送代码的完整流程。
一、准备工作
1. 安装必要工具
- Git：确保你的系统已安装 Git。
可通过终端运行git --version或 git -v 验证是否安装成功。
- VS Code：下载并安装 Visual Studio Code。
- Gitee 账号：前往 Gitee 官网 注册账号（如尚未注册）。
2. 安装 VS Code 插件（可选但推荐）
虽然 VS Code 内置了 Git 支持，但以下插件可提升体验：
- GitLens：增强 Git 功能，提供提交历史、代码作者等信息。
- Git Graph，用于可视化，方便后续版本切换
- GitHub Pull Requests and Issues：虽然名为 GitHub，但对 Gitee 也有一定兼容性（主要用于 PR 管理，非必需）。
注意：Gitee 与 GitHub 在 API 上不完全兼容，因此部分 GitHub 插件可能无法直接用于 Gitee。
二、创建 Gitee 远程仓库
1. 登录 Gitee 账号，点击右上角 “+” → “新建仓库”。
2. 填写仓库名称，选择公开或私有。
3. 不要勾选“使用 README.md 初始化”（如果你已有本地代码），否则后续推送时会因远程存在提交而冲突。下面三个建议都不勾选
4. 点击 “创建”，记录生成的仓库地址（如 https://gitee.com/yourname/my-project.git）。
三、配置本地 Git 环境
在终端（或 VS Code 内置终端）中执行以下命令：
# 配置全局用户名和邮箱（仅首次需要） git config --global user.name "你的Gitee用户名" git config --global user.email "你的Gitee注册邮箱"注意：邮箱必须与 Gitee 账号绑定的邮箱一致，否则提交记录可能无法正确关联。
四、在 VS Code 中初始化并上传项目
步骤 1：打开项目文件夹
- 启动 VS Code。
- 使用
File → Open Folder打开你的本地项目目录。
步骤 2：初始化 Git 仓库（如果尚未初始化）
如果项目目录下没有 .git 文件夹，说明尚未初始化 Git：
在vscode，点击源代码管理，初始化仓库
或者，打开 VS Code 终端（Ctrl + ～ 或 Terminal → New Terminal），使用命令初始化
git init步骤 3：添加文件并提交
1. 在 VS Code 左侧活动栏点击 源代码管理（Source Control） 图标（或按 Ctrl+Shift+G）。
（这里我忘记创建.gitignore文件了，导致所有文件都进来了，大家记得先创建.gitignore，把不需要上传的环境、静态资源等文件去掉）
2. 你会看到所有未跟踪的文件列在 “Changes （更改）” 区域。
3. 点击文件旁边的 + 图标（或点击顶部的 + 全选）将文件暂存（Stage）。
4. 在输入框中填写提交信息（如 首次提交），然后按 Ctrl+Enter 提交。
你也可以在终端中执行：
步骤 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，尝试：
或先查看本地分支名：
当然，我们使用图形化界面肯定更加方便，直接提交
首次推送时，VS Code 或系统可能会弹出认证窗口，输入你的 Gitee 账号和密码。（手机号和密码）
⚠️ 重要：自 2021 年起，Gitee（以及 GitHub）不再支持账号密码直接认证。你需要使用 个人访问令牌（Personal Access Token） 代替密码。
如何生成 Gitee 个人访问令牌？
- 登录 Gitee，进入 设置 → 私人令牌（Private Token）。
- 点击 “生成新令牌”，填写令牌名称（如
vscode-push），勾选repo权限。 - 点击 “生成”，复制生成的令牌（只显示一次，请妥善保存）。
- 推送时，用户名填 Gitee 用户名，密码填该令牌。
那么，在gitee就可以看到我们提交的消息
仓库里可以看到相关内容
五、补充问题
由于是首次操作，我们可能会忘记创建.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 的结合，开发者可以高效地进行本地开发与远程协作。整个流程核心在于：
- 初始化本地 Git 仓库；
- 创建 Gitee 远程仓库；
- 关联远程地址；
- 使用个人访问令牌安全认证；
- 推送代码。
掌握这一流程后，你不仅能上传新项目，还能轻松管理日常的版本控制与团队协作。
