教程文档【免费下载链接】easy-vibe从 0 到 1 学会 vibe coding项目制学习项目地址https://gitcode.com/datawhalechina/easy-vibe点击查看免费下载导读本文基于 Datawhale 开源项目 easy-vibe 附录知识库中《Git 版本控制原理》一文docs/ar-sa/appendix/2-development-tools/git-version-control.md同内容有 10 种语言版本系统展开。这篇指南面向完全没接触过 Git 的读者不要求你死记命令而是先理解Git 到底帮你解决什么问题再逐步串联命令与概念。学完本文你将能独立完成本地提交commit、创建分支branch、解决冲突以及把代码推送到 GitHub 等远程仓库——这是 easy-vibe 第二阶段全栈项目实践中完成 Git and GitHub Workflow 实战章节与所有项目部署环节的必备前置能力。0. 先问自己你经历过这些噩梦吗在进入命令之前先看 Git 要解决的三个真实痛点——这正是 easy-vibe 教程把这一章放在开发工具知识库的动机所在。场景一版本地狱你写论文或写代码改到一半发现改错了想回到三天前的版本——但你找不到了。项目_v1.zip 项目_v2_修改版.zip 项目_v3_最终版.zip 项目_v3_最终版_真的最终版.zip 项目_v3_最终版_打死不改了.zip每次存一个新副本硬盘越来越乱而且你根本记不住哪个版本改了什么。场景二协作噩梦你和队友同时改同一个文件你改了第 10 行添加了登录功能队友改了第 10 行修复了一个 Bug你们用邮件互发代码结果合并时一个人的改动被另一个人覆盖了没人知道最后哪段代码是对的。场景三没有后悔药你在生产环境部署了新代码结果出 Bug 了想紧急回退到上一个稳定版本——但你不知道怎么回退只能手忙脚乱地找备份。Git 就是为了解决这三个问题而生的。Git 是一个版本控制系统Version Control System。它的本质是把你每一次存档操作都记录下来形成一条完整的历史时间线让你可以随时回到任意一个历史节点。不夸张地说Git 是现代软件开发最重要的工具之一几乎所有公司、几乎所有开源项目都在使用它。在 easy-vibe 的项目 README 中附录知识库被定义为覆盖 9 大知识领域、80 交互式主题用动画和可视化组件帮你直观理解从计算机基础到 AI 前沿的核心概念见 README.mdGit 原理正是其中重要的交互式主题之一。本文档中出现的GitCommitFlow /、GitBranchVisual /、GitSyncDemo /、GitCommandCheatsheet /等组件就是该知识库为本章配套的可视化交互演示。1. Git 和 GitHub 是一回事吗很多初学者会混淆这两个概念先澄清一下GitGitHub是什么一个运行在你电脑上的版本控制工具一个存放 Git 仓库的网站云端在哪里你的本地电脑互联网上能独立使用吗✅ 可以只管理本地历史❌ 需要配合 Git 使用类比你本地的日记本存日记的云盘简单说Git 是工具GitHub 是托管服务。就像 Word 是工具、OneDrive 是云盘一样两者配合使用但并不是同一个东西。除了 GitHub类似的服务还有 GitLab、Gitee国内等。本文后续以 GitHub 为例但所有远程命令remote、push、pull、clone对 GitLab、Gitee 同样适用——这正是 easy-vibe 后续实战中把代码托管到云端、再通过 Zeabur、Vercel 等平台部署的前提。2. 核心概念三个区域这是整个 Git 最重要的设计理解了这三个区域你就理解了 Git 的灵魂。Git 把你的文件状态分成三层工作区Working Directory就是你的普通文件夹你现在看到的、正在编辑的所有文件都在这里。你随便改Git 会感知到你改了什么但不会做任何记录。暂存区Staging Area / Index这是一个**预备提交的中转站**。你可以把工作区里想要保存的文件放进暂存区就像把快递放进快递盒——还没寄出去但已经选好了要寄什么。仓库Repository这是永久存档的历史记录库藏在.git文件夹里。每次你执行git commit暂存区里的内容就会被封存进仓库形成一条不可篡改的历史记录。对应 easy-vibe 文档中的交互组件GitCommitFlow /依次点击命令按钮可以观察文件如何在这三个区域之间流转。两步走add commit的动机很多初学者会问为什么不能直接一键保存非要先add再commit因为现实开发中你经常不想把所有改动都一起提交。举个例子你今天改了 5 个文件login.js完成了登录功能想提交style.css调整了登录页样式想提交debug.log临时调试输出不想提交experiment.js正在测试的新功能还没完成不想提交todo.txt你的个人备忘不想提交如果没有暂存区你要么把这 5 个文件全部提交提交记录很混乱要么一个都不提交。有了暂存区你可以精确控制git add login.js style.css只把这两个文件放进快递盒然后commit这次提交就清清楚楚地记录登录功能完成。3. 第一次使用 Git初始化和基础工作流3.1 安装和初始化安装好 Git 后macOS 自带Windows 去 git-scm.com 下载打开终端进入你的项目文件夹# 在当前文件夹初始化一个 Git 仓库 git init # Git 会创建一个隐藏的 .git 文件夹所有历史记录存在里面 # 输出Initialized empty Git repository in .../your-project/.git/第一次使用还需要告诉 Git 你是谁这个信息会附在每次提交记录上git config --global user.name 你的名字 git config --global user.email 你的邮箱补充关于安装本身easy-vibe 的配套实战章节 Git and GitHub Workflow 给出了三大操作系统的详细安装方式Windows从 Git 官方下载页获取与系统匹配的安装包通常推荐 x64 版本双击按向导安装。默认设置即可需要留意两点默认编辑器可以保留 Vim或选择已安装的 VS CodeGit 在命令行中的使用方式建议选择加入命令行和第三方软件的实用选项。安装完成后桌面右键出现Git Bash Here即表示成功。macOS先运行git --version检查是否已安装未安装时可用brew install gitHomebrew 方式或安装 Xcode Command Line Tools。LinuxUbuntu / Debiansudo apt update sudo apt install gitCentOS / RHEL 使用sudo yum install git。安装后运行git --version验证。git config写入的身份信息会作为作者身份记录进每一次 commit——这也是 easy-vibe 实战章节中强调邮箱尽量与 GitHub 账号一致的原因这样你的提交才能正确关联到托管平台上的个人账户。3.2 日常工作流三步存档初始化之后日常开发 90% 的操作就是反复执行这三步第一步查看状态git status这是你用得最多的命令没有之一。它告诉你你在哪个分支上哪些文件被修改了红色 未暂存哪些文件在暂存区里绿色 已暂存等待提交。第二步把文件放进暂存区# 添加单个文件 git add login.js # 添加多个文件 git add login.js style.css # 添加当前文件夹里所有修改过的文件用 . 表示全部 git add .⚠️ 初学者常见误区git add .非常方便但会把所有修改都加进去包括你不想提交的临时文件。养成精确 add 的习惯或者用.gitignore排除不想追踪的文件后面会讲。第三步提交写上说明git commit -m feat: 添加用户登录功能-m后面引号里的内容叫做commit message提交说明。这是写给未来的自己和队友看的要写得有意义。3.3 Commit Message 编写规范# ❌ 没用的写法——看了不知道做了什么 git commit -m update git commit -m fix git commit -m 改了一些东西 # ✅ 好的写法类型 冒号 一句话描述 git commit -m feat: 添加用户登录功能 git commit -m fix: 修复首页在 iOS Safari 上的白屏问题 git commit -m docs: 更新 README 中的部署说明 git commit -m refactor: 将 UserService 拆分为独立模块 git commit -m style: 统一代码缩进为 2 空格常用前缀含义前缀含义feat:新功能featurefix:修复 Bugdocs:文档改动style:代码格式调整不影响功能refactor:代码重构功能不变结构优化chore:构建、工具、依赖相关test:测试相关养成这个习惯几个月后翻历史记录一眼就知道每次提交做了什么。这在团队协作中尤其重要——easy-vibe 自身就是一个多人维护、10 种语言并行演进的开源仓库规范化的提交信息正是这类协作仓库保持历史可读性的基础。3.4 查看历史记录# 详细格式每次提交的完整信息 git log # 简洁格式每行一条推荐日常使用 git log --oneline # 示例输出 # a1b2c3d (HEAD - main) feat: 添加用户登录功能 # 9f3e1b2 init: 项目初始化注意输出中的HEAD - mainHEAD是一个指针永远指向你现在所在的位置当前分支的最新提交后续学习分支时你会反复看到它的移动。4. 分支概念Branch分支是 Git 最强大、也是最让初学者困惑的功能。但理解了它之后你会发现这个设计非常优雅。4.1 分支概述用副本存档来理解想象你在玩一个角色扮演游戏游戏里有一个关键选择选择 A去挑战大 Boss开发新功能选择 B继续稳定当前局面主线不动如果你直接在主存档上做选择 A万一失败了整个游戏进度就毁了。但如果你复制一个存档在副本里去挑战 Boss打赢了把副本的成果合并回主存档打输了主存档完全没有影响删掉副本重来。Git 分支就是这个副本存档机制。在 Git 里main或master分支是你的主存档永远保持稳定可用。当你要开发新功能时你从 main 创建一个新分支在那里开发、测试完成后再合并回 main。对应 easy-vibe 文档中的交互组件GitBranchVisual /依次点击命令按钮观察分支图如何分叉、延伸、最终合并。重点关注HEAD标签的位置变化——它始终指向你当前在哪里。4.2 分支操作详解创建并切换到新分支# 方式一先创建再切换两步 git branch feature-login # 创建分支 git checkout feature-login # 切换过去 # 方式二一步到位推荐 git checkout -b feature-login # 输出Switched to a new branch feature-login创建分支后你的命令行提示符会显示当前分支名比如usermac ~/project (feature-login) $查看所有分支git branch # 输出* 表示当前所在分支 # * feature-login # main在分支上正常开发# 在 feature-login 分支上改代码、add、commit和平时完全一样 git add login.js git commit -m feat: 添加登录表单 HTML 结构 git add login.js api.js git commit -m feat: 完成登录接口对接这些提交只在feature-login分支上main分支完全不知道你做了什么。切回主分支合并# 切回 main git checkout main # 把 feature-login 的所有改动合并进来 git merge feature-login # 合并完成后可以删掉这个分支可选 git branch -d feature-login4.3 什么时候该开分支场景建议理由开发一个新功能✅ 开分支功能完成前不影响主线随时可以放弃修复线上紧急 Bug✅ 从 main 开hotfix-xxx分支修复完直接合并上线不带入未完成的功能和队友并行开发✅ 各自开分支互不干扰完成后统一通过 Pull Request 合并只改一个错别字❌ 直接在 main 改风险极低没必要额外开分支4.4 团队常用的分支策略在实际项目中团队通常会约定好分支的命名和用途分支名用途特点main/master生产环境的稳定代码只有测试通过的代码才能进来不能直接推送dev/develop日常集成分支所有功能分支先合并到这里测试通过再上 mainfeature/xxx具体功能开发如feature/user-login完成后合并到 devhotfix/xxx紧急修复从 main 创建修完直接合并回 main 和 dev5. 与队友协作远程仓库到目前为止你学的都是本地的 Git 操作——所有历史记录都存在你自己的电脑上。要和队友共享代码你需要一个远程仓库也就是 GitHub、GitLab 这样的云端存储。5.1 远程仓库的工作原理可以把远程仓库理解为团队共用的公共存档每个人在本地写代码、commit写完后push上传到远程仓库队友pull下载远程仓库的最新内容到自己本地这样大家的代码就保持同步了。对应 easy-vibe 文档中的交互组件GitSyncDemo /依次点击命令体验从关联远程仓库、推送、到拉取队友更新的完整流程。5.2 第一次推送项目到 GitHub第一步在 GitHub 上创建一个新仓库点击右上角 → New repository不要勾选初始化选项。第二步回到本地终端关联远程仓库# 把本地仓库和 GitHub 上的仓库关联起来 # origin 是远程仓库的别名是约定俗成的名字也可以改但没必要 git remote add origin https://github.com/你的用户名/仓库名.git # 确认关联成功 git remote -v # 输出 # origin https://github.com/你的用户名/仓库名.git (fetch) # origin https://github.com/你的用户名/仓库名.git (push)第三步推送本地内容到远程# 第一次推送-u 的意思是以后 git push 时默认推到 origin 的 main 分支 git push -u origin main # 之后每次推送只需要 git push5.3 日常协作的命令推送你改了东西要让队友看到git push拉取队友改了东西你要同步git pullgit pull实际上是两个命令的组合git fetch先去远程仓库下载最新的提交记录git merge把下载回来的内容合并到你当前的分支。第一次从 GitHub 获取别人的项目# 把整个远程仓库复制到本地只需要做一次 git clone https://github.com/某人/某项目.git # clone 会自动建立与远程的关联之后直接 push/pull 就行5.4 push 和 pull 的方向你的电脑本地仓库 ←→ GitHub远程仓库 git push 本地 → 远程 你改了东西上传给队友 git pull 远程 → 本地 队友改了东西下载到你这里 git clone 远程 → 本地 第一次完整复制整个仓库最佳实践每天开始工作前先git pull拿到最新代码下班或完成一个功能后git push及时备份并让队友看到你的进展。easy-vibe 的实战章节同样遵循这一节奏——每日开工先同步、每完成一个功能点就提交推送。6. 进阶处理冲突冲突是协作中不可避免的但也没那么可怕。6.1 冲突发生机制当你和队友同时修改了同一个文件的同一行在合并时 Git 不知道该用谁的版本就会产生冲突。举个例子你在login.js第 5 行写了const timeout 3000队友同时在同一行写了const timeout 5000当你git pull或git merge时Git 发现了这个矛盾就会暂停并告诉你我不知道该用哪个你来决定。6.2 冲突文件长什么样Git 会在冲突的地方插入特殊标记function login() { const url /api/login HEAD const timeout 3000 // 你的版本 const timeout 5000 // 队友的版本 feature/update-timeout return fetch(url, { timeout }) } HEAD到之间是你当前分支的内容到 xxx之间是合并过来的内容。6.3 解决冲突的方法第一步打开冲突文件找到所有标记通常 VS Code 等编辑器会自动高亮。第二步决定保留哪段代码然后手动编辑文件删掉所有标记符号、、。比如决定用 5000队友的版本function login() { const url /api/login const timeout 5000 // 采用队友的修改 return fetch(url, { timeout }) }第三步重新提交# 标记冲突已解决 git add login.js # 完成合并提交Git 会自动生成合并提交信息 git commit6.4 减少冲突的好习惯勤 pull开始工作前同步最新代码减少你落后太多的情况小步提交不要写了一周代码才一次性提交频繁小提交更容易发现和解决冲突分支隔离不同功能用不同分支减少对同一行代码的竞争沟通要改公共文件比如config.js前跟队友打个招呼。7. 常用命令速查对应 easy-vibe 文档中的交互组件GitCommandCheatsheet /。以下汇总本文全部核心命令便于随时查阅目的命令初始化仓库git init配置身份git config --global user.name 名字/git config --global user.email 邮箱查看状态git status暂存文件git add 文件/git add .提交git commit -m feat: 说明查看历史git log/git log --oneline创建分支git branch 名称切换分支git checkout 名称创建并切换git checkout -b 名称查看分支git branch合并分支git merge 分支名删除分支git branch -d 分支名关联远程git remote add origin 地址/git remote -v推送git push/ 首次git push -u origin main拉取git pullgit fetchgit merge克隆git clone 地址8. 实战加入一个团队项目的完整流程这是你加入新团队或新项目时的标准操作流程可以直接照抄# ① 第一天把项目 clone 到本地只做一次 git clone https://github.com/team/project.git cd project # ② 每天开始工作先拉取最新代码确保你的代码是最新的 git pull origin main # ③ 创建自己的功能分支不要直接在 main 上改 git checkout -b feature/user-profile # ④ 正常开发...写代码... # ⑤ 完成一个小功能点后立即提交不要攒着 git add src/UserProfile.vue git commit -m feat: 完成用户头像上传功能 git add src/UserProfile.vue src/api/user.js git commit -m feat: 完成用户资料编辑接口 # ⑥ 把自己的分支推送到远程让队友能看到 git push origin feature/user-profile # ⑦ 在 GitHub 上创建 Pull RequestPR请求合并到 main # 这步在 GitHub 网页上操作 # ⑧ 等队友 Code Review按反馈修改继续 commit push # ⑨ PR 合并后回到 main更新本地删掉功能分支 git checkout main git pull git branch -d feature/user-profile这套流程在 easy-vibe 中并非孤立存在第二阶段的所有实训项目如 Copywriting Platform文案生成平台、考试管理系统 等都把Git 与 GitHub 工作流列为发布环节的必修前置最终代码通过git push上传到远程仓库后再借助 Zeabur、Vercel 等平台完成公网部署。而 Git and GitHub Workflow 则作为本原理章的实战延续详细演示了在真实仓库中执行上述每一步的具体操作与界面。9. .gitignore哪些文件不应该被追踪有些文件你不想提交到 Git 仓库里比如node_modules/依赖包体积巨大可以用npm install重新生成.env环境变量文件里面可能有数据库密码、API Key绝对不能上传到公开仓库*.log日志文件.DS_StoremacOS 自动生成的隐藏文件dist/、build/编译产物可以重新构建。在项目根目录创建一个.gitignore文件写上不想追踪的文件规则# 依赖包 node_modules/ # 环境变量重要密码不能提交 .env .env.local # 构建产物 dist/ build/ # 系统文件 .DS_Store Thumbs.db # 日志 *.logGitHub 提供了各种语言和框架的.gitignore模板库github.com/github/gitignore创建新仓库时可直接选用对应语言模板。值得注意的是easy-vibe 仓库本身就是一个良好的范例作为 VitePress 站点项目它通过.gitignore排除了node_modules/等依赖与构建产物仅把源码、文档与配置文件纳入版本管理这正是精确 add .gitignore 排除这一理念在真实项目中的落地。名词速查表名词英文解释仓库Repository (Repo)存放项目所有版本历史的数据库在.git文件夹里提交Commit一次完整的版本记录像游戏存档点附有说明和时间戳分支Branch独立的开发线像平行时间线互不影响合并Merge把一个分支的改动整合到另一个分支冲突Conflict同一行代码被多人修改Git 不知道该用哪个需要手动解决暂存Stage / Index把修改放入准备提交列表的操作远程Remote云端的仓库副本GitHub / GitLab / Gitee克隆Clone把整个远程仓库完整复制到本地推送Push把本地提交上传到远程仓库拉取Pull把远程最新内容下载并合并到本地HEADHEAD当前所在分支/提交的指针表示你现在在哪里originorigin远程仓库的默认别名约定俗成的名字stashStash临时保存还没 commit 的改动切换任务时用PR / MRPull Request / Merge Request请求把你的分支合并进主分支通常需要队友 review结语把 Git 变成你的肌肉记忆回顾本文从三个噩梦场景出发你已经走通了 Git 的完整知识链条三个区域工作区 → 暂存区 → 仓库解释了存档的本质三步工作流status→add→commit覆盖了日常 90% 的操作分支给了你随意试错的底气远程仓库与 PR让你能够融入任何团队项目冲突处理让你面对协作摩擦不再恐慌.gitignore则守护了你的隐私与仓库整洁。接下来请打开 easy-vibe 的 Git and GitHub Workflow 实战章节在真实仓库中把本文的命令逐一敲一遍再回到第二阶段的项目实训中去实践克隆 → 建分支 → 开发 → 提交 → 推送 → 提 PR的完整闭环。Git 不靠背靠用——用上三五次之后这些命令就会成为你的肌肉记忆。赞分享教程文档【免费下载链接】easy-vibe从 0 到 1 学会 vibe coding项目制学习项目地址https://gitcode.com/datawhalechina/easy-vibe点击查看免费下载相关推荐LLJS完全入门指南如何在JavaScript中实现手动内存管理LLJS完全入门指南如何在JavaScript中实现手动内存管理 LLJSLow Level JavaScript是一种类型化的JavaScript方言编译器/解释器Easy Mock版本控制Git工作流与分支管理Easy Mock版本控制Git工作流与分支管理 痛点与解决方案 你是否在多人协作开发Easy Mock时遇到过代码冲突、版本混乱本文将详细介绍如何通过Gi后端接口测试终极指南ESP-IDF版本控制与Git协作工作流详解终极指南ESP IDF版本控制与Git协作工作流详解 ESP IDFEspressif IoT Development Framework作为乐鑫科技官方物联网嵌入式创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考