介绍如何使用 Visual Studio Code 配合 Git 将本地项目代码上传至 Gitee 远程仓库。主要步骤包括安装 Git 和 VS Code 环境，配置全局用户名和邮箱，创建 Gitee 仓库并获取地址，在 VS Code 中初始化 Git 仓库并提交代码。重点讲解了如何关联远程仓库地址以及使用个人访问令牌进行安全认证推送。此外还补充了处理 .gitignore 文件遗漏导致多余文件上传的解决方案，帮助开发者高效完成版本控制与代码托管。
在现代软件开发流程中，版本控制是不可或缺的一环。Gitee（码云）作为国内领先的代码托管平台，为开发者提供了稳定、快速的 Git 服务。本文将详细介绍如何使用 Visual Studio Code（VS Code）将本地项目代码上传至 Gitee 仓库，涵盖从环境配置、初始化仓库到推送代码的完整流程。
git --version 或 git -v 验证是否安装成功。虽然 VS Code 内置了 Git 支持，但以下插件可提升体验：
注意：Gitee 与 GitHub 在 API 上不完全兼容，因此部分 GitHub 插件可能无法直接用于 Gitee。
https://gitee.com/yourname/my-project.git）。在终端（或 VS Code 内置终端）中执行以下命令：
# 配置全局用户名和邮箱（仅首次需要）
git config --global user.name "你的 Gitee 用户名"
git config --global user.email "你的 Gitee 注册邮箱"
注意：邮箱必须与 Gitee 账号绑定的邮箱一致，否则提交记录可能无法正确关联。
File → Open Folder 打开你的本地项目目录。如果项目目录下没有 .git 文件夹，说明尚未初始化 Git：
在 VS Code 中，点击源代码管理，初始化仓库。
或者，打开 VS Code 终端（Ctrl + ~ 或 Terminal → New Terminal），使用命令初始化：
git init
Ctrl+Shift+G）。.gitignore 文件，把不需要上传的环境、静态资源等文件排除。+ 图标（或点击顶部的 + 全选）将文件暂存（Stage）。Ctrl+Enter 提交。你也可以在终端中执行：
git add .
git commit -m "首次提交"
方法 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)
执行推送命令：
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） 代替密码。
vscode-push），勾选 repo 权限。由于是首次操作，我们可能会忘记创建 .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 的结合，开发者可以高效地进行本地开发与远程协作。整个流程核心在于：
掌握这一流程后，你不仅能上传新项目，还能轻松管理日常的版本控制与团队协作。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online