Git + GitHub + VSCode 入门到实战：常用命令、术语解释与完整操作实例

VS Code 官网
Git 官网

前言

在现代软件开发中，代码版本管理已经是一项必备技能。无论是个人项目、课程作业，还是团队协作开发，Git + GitHub + VSCode 都是非常经典的组合。

本文将从以下几个方面展开：

1. 📌 Git 是什么、GitHub 是什么
2. 🔍 Git 与 GitHub 的区别
3. 📖 常用术语解释：repository、commit、branch、main、push、pull、clone 等
4. 💻 常用 Git 命令集合
5. 🛠️ VSCode 中使用 Git 的完整实操流程
6. ⚠️ 新手常见问题与注意事项

注明：不一定要使用VS Code，直接在项目文件夹内单机鼠标右键，选择在终端打开，直接在powershell中输入Git命令是一样的效果

一、Git 与 GitHub 的作用及区别

1. Git 是什么？

Git 是一个分布式版本控制系统，主要用于在本地管理代码的历史版本。

你可以把它理解成一个 “代码时间机器”：

• ✅ 记录每一次代码修改
• ✅ 随时回退到历史版本
• ✅ 支持多人并行开发
• ✅ 不依赖网络，本地也可以提交版本
• ✅ 每个开发者电脑里都有完整仓库副本

2. GitHub 是什么？

GitHub 是一个基于 Git 的远程代码托管平台。

它的作用是把本地 Git 仓库上传到云端，实现：

• ☁️ 代码远程备份
• 🔗 项目地址分享
• 👥 多人协作开发
• 📝 代码审核与讨论
• 📌 项目版本管理与发布

简单来说：

Git 负责管理你电脑里的代码历史，GitHub 负责把这些代码托管到云端，并支持协作。

---

二、Git 与 GitHub 的核心区别

表格

图标	项目	Git	GitHub
🧰	类型	本地版本控制工具	远程代码托管平台
📍	存储位置	本地电脑	云端服务器
🎯	主要作用	记录版本、管理分支、提交代码	托管仓库、分享代码、协作开发
🌐	是否需要网络	不需要，本地即可使用	需要网络，用于上传下载代码
👤	使用场景	个人开发、版本回退、分支管理	团队协作、开源项目、远程备份

---

三、常用术语解释

1. 📦 Repository（仓库 / Repo）

仓库就是一个项目文件夹，里面包含所有代码、文件和版本历史。

Git 仓库分为两种：

• 本地仓库：你电脑里的 .git 文件夹
• 远程仓库：GitHub 上托管的项目仓库

---

2. 📝 Commit（提交）

Commit 表示一次代码版本保存。

每当你完成一部分功能或修改后，都可以执行 commit，把当前改动保存到本地仓库。

例如：

git commit -m "本次提交内容的说明文本"

其中：

• -m 表示 message
• 后面写本次提交的说明
• 每次 commit 都会生成一个唯一版本记录

---

3. 🌿 Branch（分支）

分支是一条独立的开发线路。

你可以把主代码放在一个分支里，把新功能开发放在另一个分支里。

常见使用场景：

表格

分支	作用
main / master	主分支，通常保存稳定代码
dev	开发分支
feature	功能开发分支
bugfix	修复问题分支

---

4. 🚀 main / master

main 和 master 都可以表示项目的主分支。

区别在于：

• 旧版本 Git 默认主分支叫 master
• 新版本 Git 和 GitHub 默认主分支叫 main

它们的作用是一样的，都是项目的默认主分支。

---

5. 📤 Push（推送）

Push 是把本地代码提交记录上传到远程仓库。

例如：

git push origin main

意思是：

把本地 main 分支推送到 origin 远程仓库。

---

6. 📥 Pull（拉取）

Pull 是把远程仓库的最新代码下载到本地，并自动合并。

例如：

git pull origin main

作用是：

获取远程 main 分支的最新版本，并合并到本地当前分支。

---

7. 📂 Clone（克隆）

Clone 是把远程仓库完整下载到本地。

如果你想参与别人的项目，或者换一台电脑继续开发，就可以使用 clone。

例如：

git clone https://github.com/xxx/project.git

---

8. 📌 Origin

origin 是 Git 中默认的远程仓库别名。

它通常代表你 GitHub 上的项目仓库。

可以理解为：

origin 就是 “远程仓库地址” 的简称。

---

9. 🧪 Staging Area（暂存区）

暂存区是提交代码前的一个临时区域。

当你修改文件后，需要先执行：

git add .

把文件加入暂存区，然后再执行：

git commit -m "提交说明"

完成提交。

---

10. 🔄 Merge（合并）

Merge 是把一个分支的代码合并到另一个分支。

例如：

git merge dev

通常用于把开发分支合并到主分支。

---

11. 📋 Pull Request / PR

PR 是 GitHub 上的协作功能。

它的作用是：

开发者把自己的分支推送到远程后，向项目维护者申请合并代码。

维护者可以审核代码、讨论修改意见，确认没问题后再合并到主分支。

---

四、常用 Git 命令集合

1. ⚙️ 配置类命令

表格

命令	作用
git config --global user.name "用户名"	配置全局用户名
git config --global user.email "邮箱"	配置全局邮箱
git config --list	查看当前 Git 配置

示例：

git config --global user.name "Yu"
git config --global user.email "203xxx9914@qq.com"

---

2. 📁 仓库初始化与克隆

表格

命令	作用
git init	在当前文件夹初始化 Git 仓库
git clone 仓库地址	克隆远程仓库到本地
git remote add origin 仓库地址	绑定远程仓库
git remote -v	查看已绑定的远程仓库

---

3. ✅ 查看状态与提交代码

表格

命令	作用
git status	查看当前文件状态
git add 文件名	将指定文件加入暂存区
git add .	将当前目录所有文件加入暂存区
git commit -m "提交说明"	提交暂存区内容
git log	查看提交历史
git log --oneline	查看简洁版提交历史

---

4. 🌿 分支操作命令

表格

命令	作用
git branch	查看本地所有分支
git branch 分支名	创建新分支
git checkout 分支名	切换到指定分支
git checkout -b 分支名	创建并切换到新分支
git merge 分支名	合并指定分支到当前分支
git branch -d 分支名	删除已合并的分支

---

5. 📤 推送与拉取命令

表格

命令	作用
git push origin main	推送本地 main 分支到远程
git push -u origin main	首次推送并绑定上游分支
git pull origin main	拉取远程 main 分支并合并
git clone 仓库地址	克隆远程仓库到本地

---

6. 🔄 版本回退命令

表格

命令	作用
git checkout 提交编号	切换到指定提交版本
git reset --hard 提交编号	强制回退到指定版本
git checkout main	回到 main 分支最新状态

五、VSCode 中使用 Git 的完整操作实例

下面通过一个 “奶茶销售模拟项目” 来演示从创建仓库到上传 GitHub 的完整流程。

---

步骤 1 📂 创建项目文件夹

首先在电脑上创建项目文件夹，例如：

D:\github_test

然后用 VSCode 打开该文件夹。

---

步骤 2 🧰 打开 VSCode 终端

在 VSCode 中点击：

终端 → 新建终端

或使用快捷键：

Ctrl + `

或者：

---

步骤 3 ⚙️ 配置 Git 身份

首次使用 Git 时，需要配置用户名和邮箱：

git config --global user.name "你输入一个用户名"
git config --global user.email "邮箱"

查看配置是否成功：

git config --list

补充小知识

1. 当git config --list输出内容较多时，Git 会自动调用less分页工具分页展示；
2. less常用操作：
   • q键：退出；
   • 上下方向键：滚动查看内容；
   • 空格：向下翻一页；
3. 不想用分页查看可以执行：git config --list --no-pager，结果直接全部打印，不会进入分页界面。

了解内容：【3.1~3.3】 可忽略

3.1. 配置用户名 & 邮箱的作用

Git 每一次 commit（提交代码）都会记录作者身份： 你写的每一条版本记录，都会带上你的名字 + 邮箱，GitHub 靠这个识别代码是谁提交的，统计你的贡献、提交记录。

git config --global user.name "Yu"
git config --global user.email "20xxxx9914@qq.com"

• --global = 全局配置，作用范围是你电脑上所有 Git 项目
• user.name：自定义显示名字（随便填，中英文都行）
• user.email：最好填你注册 GitHub 的邮箱，GitHub 才能匹配到你的账号主页

举个例子：你提交代码后，GitHub 仓库里会显示「提交者：Yu 20xxxx9914@qq.com」，没有配置的话提交会缺失作者信息，甚至推送时报异常。

3.2. 不加 --global 的局部配置（补充）

如果某个项目想用单独一套名字邮箱，进入项目文件夹执行（去掉--global）：

git config user.name "另一个名字"
git config user.email "别的邮箱"

这个配置只对当前文件夹项目生效，其他项目还是用全局配置。

3.3、后续上传别的代码 / 新项目，还要重新配置吗？

情况 1：你用了 --global 全局配置（99% 新手都是这个）

不需要重复配置！只需要执行 1 次，永久生效。 只要不重装 Git、不手动删除配置，电脑上以后所有新项目、不同文件夹、不同 GitHub 仓库，全部自动共用这套用户名邮箱。 比如你今天上传github_test项目，下周新建爬虫项目、AI 项目，初始化 git、提交代码都不用再输这两行配置命令。

情况 2：只配置了当前项目（没加 --global）

切换到别的项目文件夹时，该新项目没有身份信息，就需要重新配置。

---

步骤 4 🚀 初始化本地 Git 仓库

在项目目录中执行：

git init

此时会生成一个隐藏的 .git 文件夹，说明本地仓库创建成功。

---

步骤 5 📄 创建项目文件

在项目中创建以下文件（随便取名，任意文件类型）：

main.py
test.txt

可以选择同时创建一个 .gitignore 文件，写入：【可选操作】

__pycache__/
*.pyc
venv/
env/
*.env
*.log
*.txt

其中： *.txt 表示所有的文件类型为txt的文件

.gitignore 的作用是：

告诉 Git 哪些文件不需要提交到仓库。

---

步骤 6 ✅ 查看文件状态

执行：

git status

可以看到当前哪些文件被修改、哪些文件还没有被跟踪。

---

步骤 7 ➕ 添加文件到暂存区

执行：

git add .

表示将当前目录下所有文件加入暂存区。

如果只想添加单个文件，可以执行：

git add main.py

---

步骤 8 📝 提交代码

执行：

git commit -m "github_test项目初始化"

git commit -m "提交内容说明"

此时代码已经保存到本地仓库。

查看提交历史：

git log --oneline

---

步骤 9 🔗 绑定远程 GitHub 仓库

先在 GitHub 上新建一个空仓库，复制仓库地址，例如：

https://github.com/1yu2005/github_test.git

---

---

然后在 VSCode 终端执行：

git remote add origin https://github.com/1yu2005/github_test.git

查看远程仓库是否绑定成功：

git remote -v

---

步骤 10 📤 推送代码到 GitHub

执行：

git branch -M main
git push -u origin main

其中：

• git branch -M main：将当前分支重命名为 main
• git push -u origin main：将本地 main 分支推送到远程仓库

如果是第一次推送，可能需要登录 GitHub。

---

步骤 11 ☁️ 刷新 GitHub 查看结果

推送成功后，刷新 GitHub 仓库页面，就能看到项目代码已经上传。

---

六、后续项目更新流程

当后续修改代码后，可以按照以下流程提交更新：

1. 查看修改状态

git status

2. 添加修改文件

git add .

3. 提交代码

git commit -m "新增xxx功能"

4. 拉取远程最新代码

git pull origin main

5. 推送到远程

git push origin main

---

七、多人协作简单示例

假设两个人共同开发一个项目，可以按下面流程操作。

开发者 A：创建仓库并添加协作者

1. 在 GitHub 创建仓库
2. 进入仓库设置
3. 添加协作者 B
4. B 接受邀请

开发者 B：克隆项目

git clone A的仓库地址.git

开发者 B：拉取最新代码

git pull origin main

开发者 B：创建开发分支

git checkout -b dev-自定义分支名

开发者 B：修改代码后提交

git add .
git commit -m "优化结算逻辑"

开发者 B：推送分支到远程

git push origin dev-先前定义的分支名

开发者 B：提交 PR

在 GitHub 页面提交 Pull Request，请求合并到 main 分支。

开发者 A：审核并合并

A 审核代码后，将 PR 合并到 main 分支。

八、删除仓库

1. 页面拉到最底部，找到红色 Danger Zone（危险区域） 区域内红色按钮：Delete this repository（删除此仓库）。
2. 点击删除按钮，弹出确认窗口

• 第一步：点 I want to delete this repository
• 第二步：阅读风险提示，勾选 I have read and understand these effects
• 第三步：输入完整仓库名，格式：你的用户名/仓库名（大小写必须完全匹配） 示例：zhangsan/demo-project