


文章目录
一、在编辑器写文件:文件、语言模式、工作区和编辑器不是一回事
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,保存后:
Ctrl+Shift+G打开 Source Control,点击 Initialize Repository;若已有仓库不要重复初始化。


- 检查当前分支名,可能是
master或main,两者均是合法名称,后面命令要用真实名称。

- 在 Changes 里检查文件差异,通过
+放进 Stage,输入如Initial commit: add HTML demo,点击 Commit。

- 选择 Publish to GitHub private repository,按提示登录并在 GitHub 新建远程仓库;发布完成需再核对 GitHub 文件和提交记录。

- 推送
Gitee:




- 在 Gitee 网页新建空仓库,先不要初始化 README、
.gitignore或许可证;通过Git: Add Remote输入 HTTPS URL,设置名称gitee。 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




