vscode连接 Gitee 并实现代码拉取、更新

Ne0inhk

— 10 min read

未创建 Gitee 仓库、VSCode 已有本地代码的状态开始，完整连接 Gitee 并实现代码拉取、更新的小白友好型步骤，我会把每个环节拆解得通俗易懂，全程覆盖命令行和 VSCode 图形化两种操作方式。

一、准备工作（必做，基础环境配置）

1. 安装 Git 并配置身份（核心前提）

Git 是连接本地代码和 Gitee 的桥梁，必须先安装并配置：

  • 下载安装 Git：访问Git 官网，根据系统（Windows/Mac/Linux）下载，安装时全部选默认选项即可（小白不用改）。
  • 验证安装：打开 VSCode → 点击左下角「终端」→ 输入命令 git --version，回车后能看到git version xxx就说明安装成功。

配置 Git 身份（和 Gitee 账号一致）：在终端输入以下两条命令（替换成你的 Gitee 用户名和邮箱）：bash运行

git config --global user.name "你的Gitee用户名" git config --global user.email "你的Gitee绑定邮箱"

（注：这一步是为了让 Gitee 识别 “谁在提交代码”，必须和 Gitee 账号信息一致）

2. 注册 / 登录 Gitee 账号

访问Gitee 官网，用手机号注册并登录（小白建议绑定邮箱，后续方便）。

3. VSCode 安装 Git 辅助插件（可选，更友好）

打开 VSCode → 左侧「扩展」→ 搜索安装以下插件（提升操作体验）：

  • GitLens（可视化 Git 提交记录）
  • Chinese（中文语言包，可选，怕英文的话装）

二、创建 Gitee 远程仓库

  1. 登录 Gitee 后，点击右上角「+」→「新建仓库」；
  2. 填写仓库信息（小白按以下填，避免踩坑）：
    • 仓库名称：和你本地代码文件夹名一致（比如my-first-project）；
    • 路径：默认即可；
    • 仓库介绍：随便填（比如 “我的第一个项目”）；
    • 开源许可证：选「None」（小白不用管）；
    • ✅ 重点：不要勾选「使用 Readme 文件初始化仓库」（否则本地代码推送时会冲突）；
    • 点击「创建」，完成后会进入仓库页面，复制仓库的HTTPS 地址（页面上能看到「克隆 / 下载」→ 选择 HTTPS，复制地址，比如https://gitee.com/你的用户名/仓库名.git）。

三、本地代码关联 Gitee 仓库并首次推送

方式 1：命令行操作（推荐，更通用）
  1. 打开 VSCode → 打开你的代码文件夹（「文件」→「打开文件夹」，选代码所在的文件夹）；
  2. 首次推送时，会弹出 Git 身份验证窗口：
    • Windows：输入你的 Gitee 用户名和密码，勾选「保存凭据」（后续不用重复输）；
    • Mac：同理输入账号密码即可。（如果验证失败，检查用户名 / 密码是否正确，或 Gitee 账号是否登录）

打开终端（VSCode 底部「终端」→「新建终端」），依次输入以下命令：bash运行

# 1. 初始化本地Git仓库（把当前文件夹变成Git可管理的仓库） git init # 2. 将所有本地代码添加到Git暂存区（. 代表所有文件） git add . # 3. 提交代码到本地仓库（引号内是提交说明，随便写，比如“首次提交代码”） git commit -m "首次提交：完成基础功能" # 4. 关联远程Gitee仓库（替换成你复制的HTTPS地址） git remote add origin https://gitee.com/你的用户名/仓库名.git # 5. 推送本地代码到Gitee（首次推送加-u，后续不用） # 注意：如果Gitee默认分支是main（新版），把master改成main git push -u origin master
方式 2：VSCode 图形化操作（小白友好，不用记命令）
  1. 打开代码文件夹后，点击 VSCode 左侧「源代码管理」（图标是分支形状）；
  2. 点击「初始化仓库」→ 确认当前文件夹，完成本地仓库初始化；
  3. 在「消息」输入框填写提交说明（比如 “首次提交”）→ 点击「提交」（对勾图标）；
  4. 点击「・・・」→「远程」→「添加远程仓库」→ 粘贴 Gitee 仓库的 HTTPS 地址，远程名称填origin（默认）→ 确认；
  5. 点击「・・・」→「推送」→ 输入 Gitee 账号密码验证，完成推送。

✅ 验证：刷新 Gitee 仓库页面，能看到你的本地代码文件，说明推送成功！

四、日常代码拉取（pull）和更新（push）

1. 拉取远程最新代码（多人协作时先拉取，避免冲突）
  • 图形化：VSCode 源代码管理 → 点击「・・・」→「拉取」→ 等待完成即可。

命令行：终端输入bash运行

git pull origin master # 分支名还是master/main，和推送时一致
2. 本地代码修改后更新到 Gitee（推送）
  1. 本地修改代码并保存；
  2. 图形化：
    • 源代码管理面板会显示修改的文件，点击「+」（暂存）→ 填写提交说明 → 点击「提交」；
    • 点击「推送」图标，完成更新。

命令行：bash运行

git add . # 添加所有修改的文件 git commit -m "修改了xxx功能" # 填写修改说明 git push origin master # 推送（首次推送后不用加-u）

五、常见小白踩坑点（避坑指南）

  1. 推送时提示「fatal: remote origin already exists」：说明本地已经关联过仓库，输入git remote remove origin删除旧关联，再重新执行git remote add origin 地址。
  2. 分支名冲突（master vs main）：Gitee 新版默认分支是main，如果推送提示分支不存在，把命令中的master改成main即可。
  3. HTTPS 验证失败：可以切换成 SSH 方式（需要配置 Gitee SSH 密钥），但小白先优先解决 HTTPS 的账号密码问题。
总结
  1. 核心前提：先安装 Git 并配置和 Gitee 一致的用户名 / 邮箱，这是所有操作的基础；
  2. 首次推送关键：创建 Gitee 仓库时不要初始化 README，避免和本地代码冲突，关联远程仓库后用git push -u origin 分支名完成首次推送；
  3. 日常操作：拉取代码用git pull，本地修改后按「add → commit → push」三步更新到 Gitee，VSCode 图形化操作可替代命令行，小白优先用图形化。

按照这个流程，你就能完成从 0 到 1 的 Gitee+VSCode 代码管理，后续多人协作或本地更新都能复用这些步骤。
 

六、详细查看（最常用）：显示关联的仓库地址

git remote -v
  • 作用：-v是--verbose的缩写，会显示每个远程仓库的「名称」+「拉取 (fetch) 地址」+「推送 (push) 地址」，能明确看到关联的 Gitee 仓库地址是否正确；

示例输出（关联 Gitee 仓库的正常情况）：

origin https://gitee.com/你的用户名/langchain-test.git (fetch) origin https://gitee.com/你的用户名/langchain-test.git (push)

七、终极解决方案：重建本地 Git 仓库（彻底清除 LFS 残留）

该方案通过删除本地所有 Git 记录（.git 目录），从零重建仓库，完全规避 LFS 残留问题，步骤简单且绝对有效：

步骤 1：备份核心 .py 文件（防止丢失）

先把项目中所有 .py 文件复制到桌面 / 其他文件夹（比如 D:\Users\Desktop\py_backup），确保代码不丢失。

步骤 2：彻底删除本地 Git 仓库（关键，清除所有 LFS 痕迹）
# 进入项目目录（确认当前路径是 D:\Users\Desktop\dp_ocr3.0） cd D:\Users\Desktop\dp_ocr3.0 # 删除 .git 目录（包含所有 Git 历史、LFS 缓存、配置，彻底清零） Remove-Item -Recurse -Force .git
步骤 3：从零重新初始化 Git 仓库（无任何 LFS 残留）
# 重新初始化空的 Git 仓库 git init # 重新配置用户名和邮箱（确保和码云一致） git config --global user.name "YH" git config --global user.email "[email protected]" # 重新添加新仓库的远程关联（新仓库地址） git remote add origin https://gitee.com/YH--L/dpocr3.git # 验证远程关联是否正确 git remote -v

✅ 验证输出必须是新仓库地址：

origin https://gitee.com/YH--L/dpocr3.git (fetch) origin https://gitee.com/YH--L/dpocr3.git (push)
步骤 4：重新添加 .py 文件并提交（全新提交，无 LFS）
# 仅添加 .py 文件（彻底避开超大文件和 LFS） git add *.py # 全新提交（无任何 LFS 相关记录） git commit -m "首次提交：基础 OCR 核心代码"

✅ 此时执行 git status 应显示：

On branch main nothing to commit, working tree clean
步骤 5：推送至新仓库（100% 成功）
# 首次推送新仓库（无 LFS 残留，直接推送） git push -u origin main
总结
  1. 核心问题：本地 .git 目录残留 LFS 元数据，换仓库也无法规避；
  2. 解决关键：删除 .git 目录重建仓库，从零开始无任何 LFS 痕迹；
  3. 核心步骤：备份代码 → 删除 .git → 重新初始化 → 关联新仓库 → 添加 .py 文件 → 提交推送；
  4. 后续保障：永远不要执行 git lfs track 等命令，用 .gitignore 忽略超大文件，避免再次触发 LFS。

八、超大文件处理

使用 Git LFS 管理超大文件（若必须保留该文件）

如果这个超大文件是项目必需的（比如核心模型、数据集），需要用 Git LFS（Large File Storage，大文件存储）来管理，码云支持 Git LFS，步骤如下：

步骤 1：安装 Git LFS
  • Windows：下载安装 Git LFS，或用命令 git lfs install（若 Git 自带 LFS）；
  • 确认安装成功：git lfs version（显示版本号即成功）。
步骤 2：初始化 Git LFS 并追踪超大文件类型
# 初始化Git LFS（全局生效） git lfs install # 追踪超大文件类型（比如.pth/.pt/.zip等，替换成你的文件后缀） git lfs track "*.pth" git lfs track "*.pt" git lfs track "*.zip" # 必须将.gitattributes文件加入版本控制（否则LFS配置不生效） git add .gitattributes
步骤 3：重新添加并提交文件
# 先撤销之前的add（若有） git reset HEAD . # 重新添加所有文件（LFS会自动处理追踪的大文件） git add . # 提交 git commit -m "feat: 使用LFS管理大文件"
步骤 4：推送代码到码云
# 推送（LFS会自动将大文件上传到码云LFS存储） git push -u origin main

⚠️ 注意：码云 Git LFS 也有配额限制（免费版一般每月流量 1GB、存储 1GB），若超出配额仍会推送失败，需根据实际情况选择。

总结
  1. 推送失败的核心原因是单个文件超过码云 100MB 限制，而非代码本身问题；
  2. 若大文件非必需：优先用「方案 1」删除并清理 Git 历史，操作简单且无配额限制；
  3. 若大文件必需：用「方案 2」Git LFS 管理，需注意码云 LFS 的配额限制；
  4. 建议在项目中添加 .gitignore，提前忽略大文件 / 临时文件，避免重复踩坑。

执行完对应方案后，重新执行 git push -u origin main 即可成功推送。

Could not load content