Brookty头像
Git版本控制:VS Code/IDEA实践、GitHub/Gitee双远程与上游分支机制封面图

Git版本控制:VS Code/IDEA实践、GitHub/Gitee双远程与上游分支机制

在这里插入图片描述在这里插入图片描述在这里插入图片描述

一、在编辑器写文件:文件、语言模式、工作区和编辑器不是一回事

1. 创建 HTML 文件

在 VS Code 打开一个文件夹(File → Open Folder...),在 Explorer 中点击 New File,输入 index.html、demo1.html 等带 .html 的名称,就建立了 HTML 文件。
也可以先 Ctrl+N 新建未命名文件,再以 Ctrl+Shift+S 保存为 index.html。
默认出现的 Text File / Untitled 是编辑器当前未命名文档的状态;扩展名 .html 能让 VS Code 自动启用 HTML 语言模式。
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

文件扩展名和语言模式需要分别判断:将右下角 Plain Text 切换为 HTML,能提供语法高亮、补全、Emmet 等编辑支持,但不会自动把未命名文档保存成磁盘上的 .html 文件。
HTML 模式下输入 ! 并确认 Emmet 建议,通常可扩展基本结构。
Ctrl+S 保存的是编辑后的文件内容;它不会自动创建 Git Commit。

最小 HTML 示例:

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>VS Code Git 练习</title>
</head>
<body>
    <h1>Hello Git!</h1>
    <p>这是我的第一个 Git 版本。</p>
</body>
</html>

2. Open Editors 与文件夹 Explorer

在这里插入图片描述
左侧 Open Editors 列出当前打开的编辑器,不负责表示文件的真实存放位置;关闭标签一般使条目从此处消失,通常不会删除磁盘文件。
下面的项目文件夹(如 Code、html)及其子文件、子目录,才是资源管理器展示的目录结构。
1 unsaved 或标签旁圆点表示有未保存的编辑内容。即使同一个 demo2.html 同时出现在这两处,也不是两份不同文件。

3. 自己代码与老师代码如何并排

有两种实际需求:

  • 只想并排看两个文件:分别 File → Open File...,在右侧编辑器将一个标签拖向右侧,或使用 Split Right / Ctrl+\ 拆分编辑器。
  • 想在侧栏同时看到两个文件夹:保留自己的文件夹,再 File → Add Folder to Workspace... 添加老师代码目录,并用 Save Workspace As... 保存多根工作区配置。

.code-workspace 文件保存工作区包含的文件夹路径与工作区设置。
例如 html.code-workspace 可以同时引用自己的 D:\Code\前端 和老师的素材目录,引用外部目录不等于把目录里的代码复制进工作区配置文件。

但若将工作区文件提交到公开 Git 仓库,可能暴露本机目录结构。老师原始材料和自己练习目录应清楚分开,避免误修改或意外上传。

二、Git 究竟在管理什么:本地项目、工作区、暂存区、提交与远程

1. Git、VS Code、IDEA、GitHub、Gitee 的职责

Git 是本地和分布式版本控制工具;VS Code/IntelliJ IDEA 是可调用 Git 的开发工具;GitHub/Gitee 提供远程 Git 仓库托管及额外的网页协作功能。
Windows 上安装一套 Git for Windows,两个编辑器通常都可以调用它。git --version 可验证命令行的 Git;在 IDEA 的 Settings → Version Control → Git 设置可执行文件路径后,点击 Test 验证 IDEA 是否能调用 Git。
两个编辑器不需要各装一套 Git。

一个本地项目文件夹并不因为能被编辑器打开就自动是 Git 仓库。
执行 git init(或点击 IDE 的 Initialize Repository / Create Git repository)后,Git 在该目录建立管理数据,通常在隐藏的 .git 目录中。
Git 的管理边界通常是该仓库根目录及其纳入跟踪的子目录;另一个 Git 仓库与它的历史独立。

2. 五个容易混淆的阶段

阶段对象/动作产生的结果
编辑并保存Ctrl+S、磁盘工作区文件改变真实文件的当前内容
暂存git add、IDE 的 Stage把选定内容放进 Git Index(暂存区)供下次提交
本地提交git commit创建新 Commit,更新当前本地分支所指提交
上传git push尝试更新服务器上的分支,并传输服务器缺少的 Git 对象
获取/整合git fetch / git pull获取远程对象及引用信息;Pull 通常还整合到当前分支

保存文件不会自动提交;本地 Commit 不会自动上传;远程网站出现新仓库并不说明代码已经上传。

在本轮实践中,曾出现 GitHub 页面有仓库但仍显示 Quick setup、没有文件列表的情况:服务器端只是创建了空仓库,尚未收到本地提交。正常推送完成后,才出现 demo1.html 等文件和历史列表。

3. 一个提交保存什么

Git 的 Commit 有自身对象 ID,记录根 Tree 引用、父提交、作者/提交者信息及说明等;Tree 表示目录结构,Blob 表示文件内容。
一个 Commit 在逻辑上定位项目的一份完整文件快照,底层未变对象能够复用,并不等于每次提交都重新物理复制全部文件。
创建 Commit 后,当前分支引用(如 main)移动到新 Commit;文件浏览、历史比较和提交图都是不同的观察方式。

本轮实践中的提交短 ID,例如 367818b、9681e76,是具体提交对象的短标识;test、Initial commit: add Java Git demo 只是提交说明,不能代替对象 ID。
网页某文件右侧显示最近一次修改该文件的说明,也不等于仓库所有提交只有这一条。

三、建立本地仓库和远程仓库的对应关系

1. 一个本地 Git 仓库可以对应几个远程

例如本地的 HTML 仓库:

D:\Code\前端\  (本地 Git 仓库)
  ├─ origin              → GitHub 仓库
  └─ JavaEECodePractice  → Gitee 仓库

origin、gitee、JavaEECodePractice 都是本地远程名称(remote name),仅用于引用 URL,不是账号、分支,
也不因为取名 JavaEECodePractice 就自动让 Java 文件归属该仓库。git remote -v 查看远程的 fetch/push 地址。

git remote -v
git remote add gitee https://gitee.com/你的用户名/idea-git-demo.git

git remote add 只保存一个名称到 URL 的映射,不上传提交,也不创建本地分支或服务器分支;
因此在 VS Code 输入 Gitee URL 和远程名称后,Gitee 页面仍是空仓库,原因是尚未进行 Push。

2. GitHub 与 Gitee 是否需要各做一次 Commit

不需要。如果两个远程仓库都接受同一段提交历史,那么本地 Commit 一次,分别推送即可:

git push origin main
git push gitee main

两个 push 的结果相互独立;一个平台成功不保证另一个也成功。
Sync Changes 通常面向当前默认远程/上游,并不会自动同步所有远程。
若两个平台随后出现不同的新提交,需要先理解并处理分叉,不能盲目 --force。

3. 什么时候一个仓库放多个项目,什么时候分开

如果目标是集中保存各类普通练习,可以使用一个仓库:

Code-Practice/
├── HTML/
├── CSS/
├── JavaEE/
│   ├── Servlet-Practice/
│   └── SpringBoot-Practice/
├── .gitignore
└── README.md

VS Code 可打开 HTML 子目录,IDEA 可打开 Java 子项目;它们使用同一外层 Git 仓库的提交历史。
需要留意 IDE 的 Git 根识别、构建目录过滤和子项目自身 .git 所形成的嵌套仓库问题。

也可以让 HTML 练习、JavaEE 练习和独立 Spring Boot 项目各自拥有 Git 仓库:提交历史、权限、远程地址、发布和维护粒度相互独立。
两种结构的关键区别是版本边界和历史边界,不是编辑器品牌。此轮 GitHub 的 -- 与 Gitee 的 JavaEE代码练习 仓库被明确界定为临时操作练习仓库,不能自动视为将来正式的课程代码存储规划。

四、VS Code 的实际 GitHub + Gitee 操作链

1. 从零练习

在 D:\Code\vscode-git-demo 创建 index.html,保存后:

  1. Ctrl+Shift+G 打开 Source Control,点击 Initialize Repository;若已有仓库不要重复初始化。在这里插入图片描述在这里插入图片描述在这里插入图片描述
  2. 检查当前分支名,可能是 master 或 main,两者均是合法名称,后面命令要用真实名称。
    在这里插入图片描述
  3. 在 Changes 里检查文件差异,通过 + 放进 Stage,输入如 Initial commit: add HTML demo,点击 Commit。
    在这里插入图片描述
  4. 选择 Publish to GitHub private repository,按提示登录并在 GitHub 新建远程仓库;发布完成需再核对 GitHub 文件和提交记录。
    在这里插入图片描述
  5. 推送
    在这里插入图片描述Gitee:在这里插入图片描述
    在这里插入图片描述在这里插入图片描述在这里插入图片描述在这里插入图片描述
  6. 在 Gitee 网页新建空仓库,先不要初始化 README、.gitignore 或许可证;通过 Git: Add Remote 输入 HTTPS URL,设置名称 gitee。
  7. git push gitee main(假设当前确是 main)首次推送 Gitee;不必为了第二个远程覆盖原本 Github 的上游设置。

继续写代码后,检查修改、Stage、Commit,再明确向两边 Push。比如:

git status
git add index.html
git commit -m "Add second HTML practice"
git push origin main
git push gitee main

其中 git add index.html 只会把指定路径的修改加入暂存,
不会盲目把所有其他文件纳入;git commit 保存本地版本,后两条才负责分别更新两个远程。

2. 实际成功证据与排查

第一次 VS Code 练习中,git status 显示 On branch main 和 nothing to commit, working tree clean,git log -1 --oneline 显示本地存在提交,git remote -v 已指向 GitHub,但 git branch -vv 尚未显示上游,远程网页还是空仓库。
这些信息共同表示:本地有提交且无待提交修改,并不证明远程已经收到提交。

后来终端出现 Writing objects: 100%、[new branch] main -> main 和 branch 'main' set up to track 'origin/main',GitHub 页面也出现 demo1.html、demo2.html、demo3.html、demo4.html、html.code-workspace 和提交记录,才可确认首次上传成功。
后来又完成 Gitee 推送并出现 main -> main、建立 JavaEECodePractice/main 上游的消息。
Gitee 端是否同步最新版本,还应与实际网页提交记录对照。

五、IDEA 的 Git 工作流:从 Java 文件到两个远程

1. IDEA 可以直接使用现有 Git

IDEA 的 Settings → Version Control → Git 指向 C:\Program Files\Git\bin\git.exe 之类的有效路径,点击 Test 验证。
GitHub 账号登录、Git 可执行文件配置、Git 作者名称和邮箱是不同设置,不要互相替代。

教学项目示例:

D:\Code\idea-git-demo\
├── .git/
├── .gitignore
├── .idea/
└── src/
    └── Main.java

使用 File → New → Project 创建 Java 项目,可选择 IntelliJ 构建系统及已安装的 JDK,勾选 Create Git repository(若版本界面提供),在 src 创建 Main.java:

public class Main {
    public static void main(String[] args) {
        System.out.println("Hello Git!");
        int a = 10;
        int b = 20;
        System.out.println("计算结果:" + (a + b));
    }
}

运行此文件的教学预期输出为 Hello Git! 和 计算结果:30。
本轮截图证明 IDEA 真实建立了项目并产生 Git 提交,不应据此假称所有教学示例都曾独立运行测试成功。

2. IDEA 的暂存与 Changelists

IDEA 默认的 Changelists(更改列表)模式允许勾选要提交的文件,Commit 过程会处理相应的 Git add/commit,因此不一定显示 VS Code 那种 + Stage。
想明确体验原生暂存区,可以在 Settings → Version Control → Git → Commit 勾选 Enable staging area(启用暂存区域)。在 Commit 工具窗口,会区分 Unstaged 与 Staged:将文件移动到 Staged,才进入 Git Index;Unstage 撤回暂存,不会自动丢弃工作区的修改。
两种 IDEA 模式最终都可以生成真实 Git Commit,只是交互流程不同。
在这里插入图片描述

在 IDEA Commit 工具窗口(通常 Alt+0)选择需要提交的文件,输入说明,执行 Commit。第一次提交、后续 Add Java practice code 和 test 均能在实际提交历史中找到。

3. IDEA 创建 GitHub 仓库和 Push

在 IDEA 可使用 Git → GitHub → Share Project on GitHub 登录 Github 账号、填写仓库名、描述、可见性并发布。
在这里插入图片描述

创建仓库成功不等于第一次 Push 成功:本轮 idea-git-demo 曾显示共享操作已经在 GitHub 创建仓库,但初始化推送报连接失败,GitHub 仍是 Quick setup 空仓库。
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

随后在 IDEA 的 Push 图形界面重新推送成功,GitHub 显示 master、.idea、src、.gitignore 等路径,以及三条提交记录,才形成完整证据。

IDEA 的 Push 窗口显示 master → origin:master:左侧 master 是当前本地分支,origin:master 表示 GitHub 远程目标;
下方三条 Commit 是将要推送的本地历史,并非只推送当前鼠标点选的一条。
右侧切换图标只决定如何查看选中提交文件,不是四种 Push 方式。
底部 Push / 仍然推送 才是执行按钮,Force Push 不能作为故障时的常规替代。

当 Push 窗口提示 提交包含问题:4 个警告,应先查看具体代码检查信息,区别一般样式提示与编译错误、敏感文件等风险。代码警告不是 github.com:443 网络连接失败的原因。

真实分支是 master 时,应执行 git push origin master,不可机械复制示例中的 main。

4. IDEA 连接 Gitee

通常在 Gitee 网页先创建空仓库,复制 HTTPS URL;在 IDEA Git → Manage Remotes 添加新远程 gitee,用 git remote -v 检查;再在 Push 对话框选择 gitee 的目标,或在 IDEA 终端执行:

git push gitee master

此处没有必要把 master 的上游从 origin/master 切换到 gitee/master;两个远程可以共享本地同一提交历史。
日后一次 Commit 后分别 Push 到两个平台即可。

七、Git 作者与 GitHub 登录账号为何不同

本轮出现了两个不同的身份标签:GitHub 仓库所有者和 IDE 登录账号为 Everett-Lorne;已创建提交的 Git 作者为 xxxxx,网页历史可能关联显示另一个昵称。
提交作者、提交者、仓库所有者、Push 认证账号并非同一字段。Git Commit 中的 author 名称/邮箱来自当时有效的 Git 配置(或其他覆盖),Push 时使用远程服务的认证凭据。
一个账号成功推送并不自动重写以前提交的作者。

通过以下命令查到本次项目作者来自 Windows 用户目录的全局 .gitconfig:

git config --show-origin --show-scope --get user.name
git config --show-origin --show-scope --get user.email
git log -3 --format="%h | %an <%ae>"

结果证明:当时 user.name=xxxxx,邮箱为原先配置的 QQ 邮箱,而且最近三次 Commit 的作者字段都是相同身份。
这是已验证的全局 Git 作者配置来源,并非 IDEA 或 VS Code 擅自把登录用户切换到另一个 GitHub 账号。
GitHub 根据提交邮箱的账户关联信息展示作者;更改 user.name 但不更新邮箱,并不能保证网页归属变为预期账号。

若打算以后新仓库默认使用 Everett-Lorne,应先到其 GitHub 账号 Settings → Emails 确认已验证邮箱,或选用 GitHub 提供的 noreply 提交邮箱,再设置:

git config --global user.name "Everett-Lorne"
git config --global user.email "替换为该GitHub账号实际可用的提交邮箱"

这是给当前 Windows 用户的全局作者默认值:以后新仓库通常继承,现有仓库若没有 local 覆盖,后续新提交也使用它。每个仓库单独的 git config --local ... 优先级更高。

已经创建的 Commit 不会因修改配置而改写;
如要修改历史作者,需要明确承担重写历史和提交 Hash 变化的影响。本文不把上述演示命令写成已经由用户执行成功的事实。

八、三个“远程相关对象”必须区分:真正远程分支、远程跟踪引用和上游关系

这一节是本轮最后两次追问形成的最重要的认识修正。

以 IDEA 的本地 master 和 GitHub 的 master 为例:

本地仓库:
  refs/heads/master          → 提交 D(本地分支)
  refs/remotes/origin/master → 提交 C(本地远程跟踪引用)
  master 的 upstream 配置   → origin/master(关系)

GitHub 服务器:
  refs/heads/master          → 提交 C(实际远程分支)

1. 本地分支

本地 master 是一个可移动引用,通常随本地普通 Commit 更新。HEAD 一般指向当前检出的本地分支;Git 提交在本地记录,不会在 Commit 完成后自动向 GitHub 发送。

2. 本地远程跟踪引用 origin/master

它是本地保存的、上次已知的服务器分支位置,属于本地 Git 的引用,不是 GitHub 服务器正在运行的那个分支,也不是“设置 upstream 后才被创造”的对象。
执行 git fetch origin 通常能用服务器现状更新它;成功的 Push 在相应映射和配置条件下也可更新对应的远程跟踪引用,因此不应绝对宣称只有 Fetch 会改变 origin/master。

它在任一时刻都可能落后于真正远程分支。例如有人在 GitHub 网页创建了 E,而本地还未 Fetch:本地 origin/master 可以仍指 C,服务器已经指向 E。
单凭本地远程跟踪引用,无法证明服务器此刻仍指 C。

3. 上游关系(Upstream)

“本地 master 跟踪 origin/master”描述的是配置关系:告诉 Git 当前分支平时与哪个远程分支相联系,用于默认 pull/某些 push 行为和领先落后状态显示。
典型本地配置可理解为:

[branch "master"]
    remote = origin
    merge = refs/heads/master

“上游分支”不是 Git 为此特别制造的一种新的分支类型。
origin/master 可以在没有上游设置时存在;有上游设置也不会保证本地 origin/master 时刻与服务器一致。

九、设置上游具体解决什么、不解决什么

1. 不设置 Upstream 也可以 Push

git push origin master

显式提供 origin 和 master 时,Git 不需要事先存在 master → origin/master 的上游关系,就知道通常要把本地 master 推送到该远程的同名分支。
相反,裸 git push 的远程和分支选择受 push.default、remote.pushDefault 等配置制约;默认 push.default=simple 常要求有适当上游关系和同名目标。因此“设不设置 upstream 无所谓”只对显式指定推送目标的这种使用方式成立,并不适用于所有无参命令。

2. 首次设置与后续使用

git push -u origin master

-u/--set-upstream 表示对推送成功的分支建立跟踪关系。已有远程跟踪引用时,也可只配置关系而不推送:

git branch --set-upstream-to=origin/master master

克隆仓库后默认分支通常已有上游;一些 IDE 首次 Push 和 push.autoSetupRemote=true 的 Git 情况下也可自动建立。
IDEA 是否自动设置,应看真实结果而不是仅凭“Push 成功”推断。核验命令:

git branch -vv
git rev-parse --abbrev-ref --symbolic-full-name '@{upstream}'

例如 * master 9681e76 [origin/master] test 表示本地 master 的上游是 origin/master。
如果没有上游,第二条可能报错。Git 配置上游不要求每次提交重新执行;新本地分支是否有上游,要看它怎样创建及相关配置。

3. 一个上游不限制多个推送目标

同一个 master 通常配置一个上游。
例如上游仍是 GitHub 的 origin/master,也可以执行:

git push origin master
git push gitee master

若为第二远程执行 git push -u gitee master,会使当前本地 master 的上游转为 gitee/master,可能改变以后默认 git pull、git status 的比较参照以及默认 Push 路由。
双平台练习时建议明确各次目标并只给需要的默认上游配置一次,不必为每个 Push 都附加 -u。

4. Ahead/Behind 的依据

假设服务器和本地已知进度到 C,本地新提交 D:

A ─ B ─ C ─ D   master
        └───── origin/master (C)

在没有远程额外提交、且远程跟踪引用准确的前提下,Git 显示本地相对上游 ahead 1;它是根据 Git 提交图的可达关系差异计数,不是比较两个 HTML 文件差了多少行,也不是比较文件夹大小。
如果服务器新增 E,但本地尚未获取,origin/master 仍在旧位置,git status 可能暂时显示与真实远端不一致的领先落后信息。Fetch 更新后,可以出现 behind 或 diverged。

十、纠正关键误区:Push 到底根据哪份远程信息决定是否允许更新?

本轮曾提出一种推测:“如果设置上游,Git Push 就只比较本地 master 与本地保存的 origin/master;为了保证 origin/master 新鲜,Push 需要先 Fetch;如果没有上游,才直接和服务器最新分支比较。”

这里混淆了两个用途:

  • 用于本地展示/默认同步的参照:上游配置和本地 origin/master。
  • 一次 Push 真实目标是否可更新的判断:当前服务器上的远程引用和 Git 的更新规则。

执行 git push origin master 时,无论有没有上游,Git 都需要与指定服务器建立连接。
服务器端会提供/协商有关远程引用的信息,客户端发送必要对象和更新请求;服务器再按 Git 的规则和仓库权限/钩子等条件验证远程分支能否更新。
普通情况下,若目标远程分支已存在,新的目标 Commit 需要满足快进条件:原远程分支顶端提交是新顶端提交的祖先。不能仅凭本地先前缓存的 origin/master 判定 Push 一定会成功。

举例:

共同历史 A─B─C
本地 master:        A─B─C─D
服务器 master:      A─B─C─E
本地 origin/master: A─B─C  (尚未 fetch)

这时本地的缓存 C 很旧。即使 D 是 C 的后代,服务器真正的分支已在 E;普通 Push D 到远程 master 一般会被拒绝为 non-fast-forward,因为 E 并不是 D 的祖先。
设置不设置 upstream 都不能绕过这一检查。
需要先获取和整合 E 的变更,确定最终提交历史,再推送。

反之,若服务器仍在 C,而本地 D 以 C 为祖先,即使没有预先运行 git fetch,也可直接 Push 成功。Push 不需要先刷新本地远程跟踪引用,才能由服务器完成真实远程分支检查。

本轮对 Git 协议和引用更新达到了“客户端要与服务器通信、服务器核验、不能只凭本地缓存”的原理层级;具体报文格式、并发引用更新、receive-pack 事务细节尚未教学,不能虚构成已深入掌握。

相关命令的状态变化应这样区别:

命令主要行为是否自动整合到当前本地分支
git fetch origin下载需要的对象,更新相应远程跟踪引用否
git pull按目标先 Fetch,再按设置 Merge 或 Rebase 等通常是
git push origin master尝试更新服务器上的远程分支;成功后相应本地远程跟踪引用也可能更新否,不会替你合并远程新提交
git branch -u origin/master master只写本地上游跟踪配置否,也不传输提交

这里的 Push 是Git 版本分支的引用更新,并非“把本地和远程两个文件逐个比较之后覆盖”。
文件树内容通过提交对象和必要对象传输来表示;快进判定关注的是提交祖先关系。

十一、命令与界面诊断:如何知道进行到了哪一步

# Git 是否可调用
git --version

# 工作区/暂存区状态
git status

# 本地仓库已配置的远程地址
git remote -v

# 当前分支、上游与提交简述
git branch -vv

# 最近三次真实提交作者
git log -3 --format="%h | %an <%ae>"

# 当前仓库中实际生效的作者与来源
git config --show-origin --show-scope --get user.name
git config --show-origin --show-scope --get user.email

# 上游分支的精确名称
git rev-parse --abbrev-ref --symbolic-full-name '@{upstream}'

working tree clean 只能说明工作区没有相对 Index/HEAD 的待处理变化,不等于已经 Push;
Publish Branch 常表示尚未发布到所需远程/没有完成对应发布流程,具体仍需查实际远程及上游;远程网页显示 Commit 和文件则是核验实际服务器结果的重要证据。创建远程空仓库、登录授权成功、本地 Commit 成功、远程 Push 成功,是不同的验收点。

首次发布时可以检查目标地址、分支名、是否已有上游;之后日常操作可保持:保存文件 → 检查变化 → 暂存选定内容 → 本地 Commit → 分别 Push 到指定平台 → 查看远程提交。

避免因为方便而 git add . 无差别纳入 IDE 缓存、构建产物、凭据。
公开仓库尤其应检查隐私文件;.gitignore 只能影响未跟踪文件的忽略规则,不能自动抹掉历史上已经提交的秘密。
在这里插入图片描述

转载自 CSDN-专业IT技术社区

原文链接:https://blog.csdn.net/2401_86112610/article/details/170672990

文章来源转载

评论

评论列表

微信小程序
QQ小程序

关于作者

点赞数:0
关注数:0
粉丝:0
文章:0
关注标签:0
加入于:--