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

Git + GitHub + VSCode 入门到实战:常用命令、术语解释与完整操作实例 VS Code 官网Git 官网前言在现代软件开发中代码版本管理已经是一项必备技能。无论是个人项目、课程作业还是团队协作开发Git GitHub VSCode 都是非常经典的组合。本文将从以下几个方面展开 Git 是什么、GitHub 是什么 Git 与 GitHub 的区别 常用术语解释repository、commit、branch、main、push、pull、clone 等 常用 Git 命令集合️ VSCode 中使用 Git 的完整实操流程⚠️ 新手常见问题与注意事项注明不一定要使用VS Code直接在项目文件夹内单机鼠标右键选择在终端打开直接在powershell中输入Git命令是一样的效果一、Git 与 GitHub 的作用及区别1. Git 是什么Git 是一个分布式版本控制系统主要用于在本地管理代码的历史版本。你可以把它理解成一个 “代码时间机器”✅ 记录每一次代码修改✅ 随时回退到历史版本✅ 支持多人并行开发✅ 不依赖网络本地也可以提交版本✅ 每个开发者电脑里都有完整仓库副本2. GitHub 是什么GitHub 是一个基于 Git 的远程代码托管平台。它的作用是把本地 Git 仓库上传到云端实现☁️ 代码远程备份 项目地址分享 多人协作开发 代码审核与讨论 项目版本管理与发布简单来说Git 负责管理你电脑里的代码历史GitHub 负责把这些代码托管到云端并支持协作。二、Git 与 GitHub 的核心区别表格图标项目GitGitHub类型本地版本控制工具远程代码托管平台存储位置本地电脑云端服务器主要作用记录版本、管理分支、提交代码托管仓库、分享代码、协作开发是否需要网络不需要本地即可使用需要网络用于上传下载代码使用场景个人开发、版本回退、分支管理团队协作、开源项目、远程备份三、常用术语解释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 / mastermain和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.git8. Originorigin是 Git 中默认的远程仓库别名。它通常代表你 GitHub 上的项目仓库。可以理解为origin 就是 “远程仓库地址” 的简称。9. Staging Area暂存区暂存区是提交代码前的一个临时区域。当你修改文件后需要先执行git add .把文件加入暂存区然后再执行git commit -m 提交说明完成提交。10. Merge合并Merge 是把一个分支的代码合并到另一个分支。例如git merge dev通常用于把开发分支合并到主分支。11. Pull Request / PRPR 是 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 203xxx9914qq.com2. 仓库初始化与克隆表格命令作用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补充小知识当git config --list输出内容较多时Git 会自动调用less分页工具分页展示less常用操作q键退出上下方向键滚动查看内容空格向下翻一页不想用分页查看可以执行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 20xxxx9914qq.com--global全局配置作用范围是你电脑上所有 Git 项目user.name自定义显示名字随便填中英文都行user.email最好填你注册 GitHub 的邮箱GitHub 才能匹配到你的账号主页举个例子你提交代码后GitHub 仓库里会显示「提交者Yu 20xxxx9914qq.com」没有配置的话提交会缺失作者信息甚至推送时报异常。3.2. 不加 --global 的局部配置补充如果某个项目想用单独一套名字邮箱进入项目文件夹执行去掉--globalgit 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将当前分支重命名为 maingit push -u origin main将本地 main 分支推送到远程仓库如果是第一次推送可能需要登录 GitHub。步骤 11 ☁️ 刷新 GitHub 查看结果推送成功后刷新 GitHub 仓库页面就能看到项目代码已经上传。六、后续项目更新流程当后续修改代码后可以按照以下流程提交更新1. 查看修改状态git status2. 添加修改文件git add .3. 提交代码git commit -m 新增xxx功能4. 拉取远程最新代码git pull origin main5. 推送到远程git push origin main七、多人协作简单示例假设两个人共同开发一个项目可以按下面流程操作。开发者 A创建仓库并添加协作者在 GitHub 创建仓库进入仓库设置添加协作者 BB 接受邀请开发者 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 分支。八、删除仓库页面拉到最底部找到红色Danger Zone危险区域区域内红色按钮Delete this repository删除此仓库。点击删除按钮弹出确认窗口第一步点I want to delete this repository第二步阅读风险提示勾选I have read and understand these effects第三步输入完整仓库名格式你的用户名/仓库名大小写必须完全匹配 示例zhangsan/demo-project