easy-vibe Git 版本控制实战指南从零掌握本地提交、分支管理与 GitHub 协作【免费下载链接】easy-vibe vibe coding 101The first course for AI-native product builders.项目地址: https://gitcode.com/GitHub_Trending/ea/easy-vibe本文是 easy-vibe 课程体系附录系统化知识全景中开发工具篇的核心章节面向从未接触过 Git 的初学者。我们不急着让你背命令而是先讲清楚Git 到底帮你解决了什么问题再把命令与概念逐步挂钩。学完本文你将能独立完成本地提交commit、创建分支branch并推送到 GitHubpush具备加入任何团队项目的版本控制基本功。0. 先问一个问题这些噩梦你经历过吗场景一版本地狱写论文或写代码到一半发现写错了想回到三天前的版本——但那个版本已经找不到了。Projekt_v1.zip Projekt_v2_bearbeitet.zip Projekt_v3_final.zip Projekt_v3_final_wirklich_final.zip Projekt_v3_final_echt_letztmalig.zip每存一个新副本硬盘就变得更乱而且你根本记不清哪个版本改了什么东西。场景二协作噩梦你和同事同时改同一个文件你改了第 10 行加了一个登录功能同事也改了第 10 行修了一个 Bug你们通过邮件互相传代码合并时一方的改动覆盖了另一方最后没人知道哪个版本是对的。场景三没有后悔药你把新代码部署到了生产环境结果出现 Bug。你想立刻回滚到上一个稳定版本——却不知道怎么回滚只能手忙脚乱地找备份。Git 正是为了解决这三个问题而生的。Git 是一种版本控制系统Version Control System。它的本质是把你每一次保存操作都记录下来形成一条完整的历史时间线让你随时可以回到任意一个历史节点。毫不夸张地说Git 是现代软件开发中最重要的工具之一。几乎所有公司和所有开源项目都在使用它。1. 先分清概念Git 与 GitHub 不是一回事很多初学者会把这两个概念混为一谈先来理清GitGitHub它是什么运行在你电脑上的版本控制工具托管 Git 仓库的网站云端它在哪里你的本地电脑互联网上能否独立使用✅ 可以只管本地历史❌ 必须配合 Git 使用类比你本地的日记本日记本的云端存储一句话总结Git 是工具GitHub 是托管服务。就像 Word 是工具、OneDrive 是云端一样——两者配合使用但不是同一个东西。除了 GitHub类似的托管服务还有 GitLab、Gitee国内等。2. 核心概念三大区域这是 Git 全身上下最重要的设计。理解这三个区域你就理解了 Git 的灵魂。Git 把文件状态分成三个层次工作目录Working Directory这就是你的普通文件夹。你现在看到、正在编辑的所有文件都在这里。你可以随意修改——Git 能感知到你的改动但不会做任何记录。暂存区Staging Area / Index这是一个**提交前的临时中转站**。你可以把工作目录里想保存的文件放进暂存区——就像把包裹放进寄件箱还没寄出去但已经挑好了要寄什么。仓库Repository这是永久保存的历史档案库藏在.git文件夹里。每当你执行git commit暂存区的内容就会被封存进仓库形成一条不可变的历史记录。在原文档页面中这一节配有GitCommitFlow /交互组件依次点击命令按钮就能直观地看到文件如何在三个区域之间流转。该组件是 easy-vibe 文档体系中内置的 VitePress 交互演示见 AGENTS.md 中关于附录页内交互 Vue 组件的说明本地运行npm run dev后即可在对应页面实际操作体验。为什么是两步走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 安装与初始化macOS 通常自带 GitWindows 需要从 git-scm.com 下载安装包。如果你需要更系统的安装指引easy-vibe 的Git 实战篇提供了 Windows官方安装包 Git Bash、macOSHomebrew 的brew install git或 Xcode 自带、LinuxUbuntu/Debian 的sudo apt install git、CentOS/RHEL 的sudo yum install git三种方式的完整说明安装完成后用git --version验证。装好后打开终端进入你的项目文件夹# 在当前目录初始化一个 Git 仓库 git init # Git 会创建一个隐藏的 .git 文件夹所有历史都存放在里面 # 输出Initialized empty Git repository in .../your-project/.git/首次使用还要告诉 Git 你是谁这条信息会附加到每一次提交上git config --global user.name 你的名字 git config --global user.email 你的邮箱--global表示全局生效一次配置本机所有仓库通用。Git 会把这些信息作为作者信息嵌入每条提交记录中——当你用git log查看历史时能清楚地看到哪行代码是谁改的这在协作项目中尤其重要。可用git config --list查看当前全部配置确认设置成功。3.2 日常工作流三步保存法初始化之后日常开发 90% 的工作就是重复这三步第 1 步查看状态git status这是使用频率最高的命令。它会告诉你当前在哪个分支上哪些文件被修改了红色 尚未暂存哪些文件在暂存区里绿色 已暂存等待提交。第 2 步把文件放入暂存区# 添加单个文件 git add login.js # 添加多个文件 git add login.js style.css # 添加当前目录下所有改动的文件. 表示全部 git add .⚠️ 常见新手坑git add .很方便但会把所有改动都加进来包括你并不想提交的临时文件。请养成精确 add 的习惯或用.gitignore排除不想跟踪的文件后面会讲。第 3 步提交并写描述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 仓库中有直接的实践佐证仓库根目录的 AGENTS.mdCommit Pull Request Guidelines 一节明确约定提交遵循历史中可见的 Conventional Commits 风格feat: ...、fix: ...、docs: ...可选带 scope如feat(docs): ...并要求 PR 附带简短描述、UI/组件变更的截图/GIF 以及涉及的路径。也就是说本文讲的这套规范正是该仓库自身实际使用的提交风格。3.4 查看历史# 详细格式每条提交的完整信息 git log # 紧凑格式每条提交一行日常使用推荐 git log --oneline # 示例输出 # a1b2c3d (HEAD - main) feat: 添加用户登录功能 # 9f3e1b2 init: 初始化项目--oneline输出的每一行前半段是提交哈希如a1b2c3d括号里是当前分支位置标记HEAD后半段就是提交说明。4. 并行宇宙分支Branch分支是 Git 最强大、也最容易让初学者困惑的功能。一旦理解你会发现这个设计非常优雅。4.1 用存档拷贝理解分支想象你在玩一个角色扮演游戏面临关键抉择选择 A去挑战大 Boss开发新功能选择 B维持现状、稳步发育主线保持不变如果你直接在主存档里选 A 并且失败了整个游戏进度就毁了。但如果你复制一份存档在副本里去挑战 Boss赢了把副本的成果合并回主存档输了主存档毫发无损——删掉副本重来。Git 分支就是这套存档拷贝机制。在 Git 中main或master分支就是你的主存档必须始终稳定可用。要开发新功能时从 main 拉出一个新分支在分支上开发、测试完成后合并回 main。原文档页面中的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: 完成登录 API 对接这些提交只存在于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生产环境的稳定代码只允许通过测试的代码进入禁止直接 pushdev/develop日常集成分支所有功能分支先合到这里测试通过后再进 mainfeature/xxx具体功能开发如feature/user-login完成后并入 devhotfix/xxx紧急修复从 main 拉出修完后直接并入 main 和 dev5. 与同事协作远程仓库到目前为止你学的都是本地Git 操作——所有历史只存在你自己的电脑上。要跟同事共享代码你需要一个远程仓库Remote Repository也就是 GitHub、GitLab 这类云端存储。5.1 远程仓库的工作原理把远程仓库理解为团队的**共享存档**每个人在本地写代码、提交完成后用push上传更新远程仓库同事用pull下载把最新内容拉到自己本地大家的代码就这样保持同步。原文档页面中的GitSyncDemo /交互组件可以带你体验从关联远程仓库、push到 pull 同事更新的完整过程。5.2 首次把项目推送到 GitHub第 1 步在 GitHub 上新建一个仓库右上角 → New repository不要勾选任何初始化选项README、.gitignore、license 都先不勾。第 2 步回到本地终端关联远程仓库# 将本地仓库与 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)第 3 步把本地内容推送到远程# 首次推送-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及时备份并让同事看到你的进度。5.5 免密认证SSH 密钥用 HTTPS 地址推送时每次都要输用户名密码或 Personal Access Token比较繁琐。easy-vibe 的SSH 认证详解和Git 实战篇给出了完整的免密方案核心流程是# 1. 生成密钥对-t 指定算法 ed25519-C 填注册邮箱 ssh-keygen -t ed25519 -C youremail.com # 一路回车接受默认路径 ~/.ssh/id_ed25519私钥永不外传公钥 id_ed25519.pub 上传到 GitHub # 2. 把公钥内容添加到 GitHubSettings → SSH and GPG keys → New SSH key # 3. 验证是否绑定成功 ssh -T gitgithub.com # 成功会看到Hi 用户名! Youve successfully authenticated... # 4. 之后改用 SSH 格式地址操作仓库 git remote set-url origin gitgithub.com:用户名/仓库名.git原理上SSH 认证基于非对称加密的密钥对本地用私钥签名操作请求GitHub 用你绑定的公钥验证——私钥从不传输因此比密码更安全也更省事。需要注意每台设备都要生成独立的密钥对并分别绑定私钥一旦泄露应立即在 GitHub 删除对应公钥并重新生成。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 如何解决冲突第 1 步打开冲突文件找到所有标记VS Code 等编辑器通常会自动高亮这些标记。第 2 步决定保留哪段代码手动编辑文件删掉所有标记符号、、。例如决定采用 5000同事的版本function login() { const url /api/login const timeout 5000 // 采纳同事的改动 return fetch(url, { timeout }) }第 3 步重新提交# 将冲突标记为已解决 git add login.js # 完成合并提交Git 会自动生成合并提交信息 git commit6.4 减少冲突的好习惯勤拉取开工前先同步最新代码避免落后太多小步提交不要攒一周的代码一次提交频繁的小提交更容易定位和解决冲突分支隔离不同功能用不同分支减少同一行代码的竞争及时沟通改动共享文件如config.js之前先跟同事打声招呼。7. 命令速查表原文档页面的GitCommandCheatsheet /交互组件以分类速查卡片的形式呈现下列命令这里整理成可随时查阅的表格场景命令说明初始化git init在当前目录创建仓库克隆git clone 地址完整拷贝远程仓库到本地状态git status查看当前分支与文件改动状态暂存git add 文件/git add .把改动放入暂存区提交git commit -m feat: ...把暂存区内容固化为一条历史记录历史git log/git log --oneline查看提交历史分支git branch列出所有分支* 为当前分支建分支git branch 名创建分支切分支git checkout 名切换分支建并切git checkout -b 名一步创建并切换推荐合并git merge 分支把指定分支合并进当前分支删分支git branch -d 名删除已合并的分支关联远程git remote add origin 地址关联远程仓库约定别名 origin查看远程git remote -v查看远程仓库关联信息推送git push/git push -u origin main上传本地提交到远程拉取git pull下载远程内容并合并fetch merge配置git config --global user.name/email设置提交作者信息暂存变更git stash临时保存未提交的改动便于切换任务8. 实战加入团队项目的完整流程这是你加入一个新团队或新项目时的标准流程——可以直接照抄# ① 第一天把项目克隆到本地仅一次 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: 完成用户资料编辑 API 对接 # ⑥ 把自己的分支推送到远程让同事能看到 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关于第 ⑦ 步的 PR 规范easy-vibe 仓库本身就是很好的范本AGENTS.md 约定 PR 应包含简短描述、UI 或组件变更的截图/GIF、以及涉及的路径如docs/zh-cn/appendix/...、docs/.vitepress/theme/...。这套流程提交规范 分支隔离 代码评审正是现代团队协作的标准形态。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 模板库创建仓库时可直接选用对应模板在 New repository 页面勾选 Add .gitignore 并从下拉列表中选择也可以在对应模板项目中检索适合自己技术栈的规则。10. 术语表术语英文解释仓库Repository (Repo)存放项目全部版本历史的数据库位于.git文件夹提交Commit一条完整的版本记录类似游戏存档带描述和时间戳分支Branch独立的开发线像互不影响的平行时间线合并Merge把一个分支的改动整合进另一个分支冲突Conflict同一行代码被多人修改Git 不知道该用哪个版本需要手动解决暂存Stage / Index把改动放入待提交清单的操作远程Remote仓库的云端副本GitHub / GitLab / Gitee克隆Clone把整个远程仓库完整拷贝到本地推送Push把本地提交上传到远程仓库拉取Pull下载远程最新内容并在本地合并HEADHEAD指向当前分支/提交的指针表示你现在在哪里originorigin远程仓库的默认别名约定俗成的名字stashStash临时保存未提交的改动切换任务时很有用PR / MRPull Request / Merge Request申请把自己的分支合并进主分支通常需要团队评审11. 在 easy-vibe 中继续深入本文定位是原理 核心命令当你准备真正动手建议接着阅读以下仓库内文档Git 实战篇Git 与 GitHub 使用入门——多平台安装、GitHub 账号注册、首次创建远程仓库、SSH 绑定、以及在 AI IDETrae中用自然语言完成 clone / pull / commit / push 的实操全流程是本文的实战延续SSH 认证安全通信——密钥对原理、ssh-keygen参数、SSH Config 别名与常见问题排查命令行与 Shell基础——Git 全部操作都发生在终端里掌握ls、cd、mkdir等基础命令是前提附录首页——easy-vibe 的完整知识库索引可以按需查阅网络、数据库、部署等其他主题。版本控制能力是 AI 原生开发者vibe coding的基本功无论你用 AI 生成了多少代码最终都要靠 Git 来管理版本、隔离实验、回归历史与团队协作。把本文的命令练熟再结合实战篇完成一次完整的克隆 → 建分支 → 提交 → 推送 → PR流程你就正式具备了现代开发者的协作基础设施。【免费下载链接】easy-vibe vibe coding 101The first course for AI-native product builders.项目地址: https://gitcode.com/GitHub_Trending/ea/easy-vibe创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 easy-vibe Git 版本控制实战指南：从零掌握本地提交、分支管理与 GitHub 协作
easy-vibe Git 版本控制实战指南从零掌握本地提交、分支管理与 GitHub 协作【免费下载链接】easy-vibe vibe coding 101The first course for AI-native product builders.项目地址: https://gitcode.com/GitHub_Trending/ea/easy-vibe本文是 easy-vibe 课程体系附录系统化知识全景中开发工具篇的核心章节面向从未接触过 Git 的初学者。我们不急着让你背命令而是先讲清楚Git 到底帮你解决了什么问题再把命令与概念逐步挂钩。学完本文你将能独立完成本地提交commit、创建分支branch并推送到 GitHubpush具备加入任何团队项目的版本控制基本功。0. 先问一个问题这些噩梦你经历过吗场景一版本地狱写论文或写代码到一半发现写错了想回到三天前的版本——但那个版本已经找不到了。Projekt_v1.zip Projekt_v2_bearbeitet.zip Projekt_v3_final.zip Projekt_v3_final_wirklich_final.zip Projekt_v3_final_echt_letztmalig.zip每存一个新副本硬盘就变得更乱而且你根本记不清哪个版本改了什么东西。场景二协作噩梦你和同事同时改同一个文件你改了第 10 行加了一个登录功能同事也改了第 10 行修了一个 Bug你们通过邮件互相传代码合并时一方的改动覆盖了另一方最后没人知道哪个版本是对的。场景三没有后悔药你把新代码部署到了生产环境结果出现 Bug。你想立刻回滚到上一个稳定版本——却不知道怎么回滚只能手忙脚乱地找备份。Git 正是为了解决这三个问题而生的。Git 是一种版本控制系统Version Control System。它的本质是把你每一次保存操作都记录下来形成一条完整的历史时间线让你随时可以回到任意一个历史节点。毫不夸张地说Git 是现代软件开发中最重要的工具之一。几乎所有公司和所有开源项目都在使用它。1. 先分清概念Git 与 GitHub 不是一回事很多初学者会把这两个概念混为一谈先来理清GitGitHub它是什么运行在你电脑上的版本控制工具托管 Git 仓库的网站云端它在哪里你的本地电脑互联网上能否独立使用✅ 可以只管本地历史❌ 必须配合 Git 使用类比你本地的日记本日记本的云端存储一句话总结Git 是工具GitHub 是托管服务。就像 Word 是工具、OneDrive 是云端一样——两者配合使用但不是同一个东西。除了 GitHub类似的托管服务还有 GitLab、Gitee国内等。2. 核心概念三大区域这是 Git 全身上下最重要的设计。理解这三个区域你就理解了 Git 的灵魂。Git 把文件状态分成三个层次工作目录Working Directory这就是你的普通文件夹。你现在看到、正在编辑的所有文件都在这里。你可以随意修改——Git 能感知到你的改动但不会做任何记录。暂存区Staging Area / Index这是一个**提交前的临时中转站**。你可以把工作目录里想保存的文件放进暂存区——就像把包裹放进寄件箱还没寄出去但已经挑好了要寄什么。仓库Repository这是永久保存的历史档案库藏在.git文件夹里。每当你执行git commit暂存区的内容就会被封存进仓库形成一条不可变的历史记录。在原文档页面中这一节配有GitCommitFlow /交互组件依次点击命令按钮就能直观地看到文件如何在三个区域之间流转。该组件是 easy-vibe 文档体系中内置的 VitePress 交互演示见 AGENTS.md 中关于附录页内交互 Vue 组件的说明本地运行npm run dev后即可在对应页面实际操作体验。为什么是两步走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 安装与初始化macOS 通常自带 GitWindows 需要从 git-scm.com 下载安装包。如果你需要更系统的安装指引easy-vibe 的Git 实战篇提供了 Windows官方安装包 Git Bash、macOSHomebrew 的brew install git或 Xcode 自带、LinuxUbuntu/Debian 的sudo apt install git、CentOS/RHEL 的sudo yum install git三种方式的完整说明安装完成后用git --version验证。装好后打开终端进入你的项目文件夹# 在当前目录初始化一个 Git 仓库 git init # Git 会创建一个隐藏的 .git 文件夹所有历史都存放在里面 # 输出Initialized empty Git repository in .../your-project/.git/首次使用还要告诉 Git 你是谁这条信息会附加到每一次提交上git config --global user.name 你的名字 git config --global user.email 你的邮箱--global表示全局生效一次配置本机所有仓库通用。Git 会把这些信息作为作者信息嵌入每条提交记录中——当你用git log查看历史时能清楚地看到哪行代码是谁改的这在协作项目中尤其重要。可用git config --list查看当前全部配置确认设置成功。3.2 日常工作流三步保存法初始化之后日常开发 90% 的工作就是重复这三步第 1 步查看状态git status这是使用频率最高的命令。它会告诉你当前在哪个分支上哪些文件被修改了红色 尚未暂存哪些文件在暂存区里绿色 已暂存等待提交。第 2 步把文件放入暂存区# 添加单个文件 git add login.js # 添加多个文件 git add login.js style.css # 添加当前目录下所有改动的文件. 表示全部 git add .⚠️ 常见新手坑git add .很方便但会把所有改动都加进来包括你并不想提交的临时文件。请养成精确 add 的习惯或用.gitignore排除不想跟踪的文件后面会讲。第 3 步提交并写描述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 仓库中有直接的实践佐证仓库根目录的 AGENTS.mdCommit Pull Request Guidelines 一节明确约定提交遵循历史中可见的 Conventional Commits 风格feat: ...、fix: ...、docs: ...可选带 scope如feat(docs): ...并要求 PR 附带简短描述、UI/组件变更的截图/GIF 以及涉及的路径。也就是说本文讲的这套规范正是该仓库自身实际使用的提交风格。3.4 查看历史# 详细格式每条提交的完整信息 git log # 紧凑格式每条提交一行日常使用推荐 git log --oneline # 示例输出 # a1b2c3d (HEAD - main) feat: 添加用户登录功能 # 9f3e1b2 init: 初始化项目--oneline输出的每一行前半段是提交哈希如a1b2c3d括号里是当前分支位置标记HEAD后半段就是提交说明。4. 并行宇宙分支Branch分支是 Git 最强大、也最容易让初学者困惑的功能。一旦理解你会发现这个设计非常优雅。4.1 用存档拷贝理解分支想象你在玩一个角色扮演游戏面临关键抉择选择 A去挑战大 Boss开发新功能选择 B维持现状、稳步发育主线保持不变如果你直接在主存档里选 A 并且失败了整个游戏进度就毁了。但如果你复制一份存档在副本里去挑战 Boss赢了把副本的成果合并回主存档输了主存档毫发无损——删掉副本重来。Git 分支就是这套存档拷贝机制。在 Git 中main或master分支就是你的主存档必须始终稳定可用。要开发新功能时从 main 拉出一个新分支在分支上开发、测试完成后合并回 main。原文档页面中的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: 完成登录 API 对接这些提交只存在于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生产环境的稳定代码只允许通过测试的代码进入禁止直接 pushdev/develop日常集成分支所有功能分支先合到这里测试通过后再进 mainfeature/xxx具体功能开发如feature/user-login完成后并入 devhotfix/xxx紧急修复从 main 拉出修完后直接并入 main 和 dev5. 与同事协作远程仓库到目前为止你学的都是本地Git 操作——所有历史只存在你自己的电脑上。要跟同事共享代码你需要一个远程仓库Remote Repository也就是 GitHub、GitLab 这类云端存储。5.1 远程仓库的工作原理把远程仓库理解为团队的**共享存档**每个人在本地写代码、提交完成后用push上传更新远程仓库同事用pull下载把最新内容拉到自己本地大家的代码就这样保持同步。原文档页面中的GitSyncDemo /交互组件可以带你体验从关联远程仓库、push到 pull 同事更新的完整过程。5.2 首次把项目推送到 GitHub第 1 步在 GitHub 上新建一个仓库右上角 → New repository不要勾选任何初始化选项README、.gitignore、license 都先不勾。第 2 步回到本地终端关联远程仓库# 将本地仓库与 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)第 3 步把本地内容推送到远程# 首次推送-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及时备份并让同事看到你的进度。5.5 免密认证SSH 密钥用 HTTPS 地址推送时每次都要输用户名密码或 Personal Access Token比较繁琐。easy-vibe 的SSH 认证详解和Git 实战篇给出了完整的免密方案核心流程是# 1. 生成密钥对-t 指定算法 ed25519-C 填注册邮箱 ssh-keygen -t ed25519 -C youremail.com # 一路回车接受默认路径 ~/.ssh/id_ed25519私钥永不外传公钥 id_ed25519.pub 上传到 GitHub # 2. 把公钥内容添加到 GitHubSettings → SSH and GPG keys → New SSH key # 3. 验证是否绑定成功 ssh -T gitgithub.com # 成功会看到Hi 用户名! Youve successfully authenticated... # 4. 之后改用 SSH 格式地址操作仓库 git remote set-url origin gitgithub.com:用户名/仓库名.git原理上SSH 认证基于非对称加密的密钥对本地用私钥签名操作请求GitHub 用你绑定的公钥验证——私钥从不传输因此比密码更安全也更省事。需要注意每台设备都要生成独立的密钥对并分别绑定私钥一旦泄露应立即在 GitHub 删除对应公钥并重新生成。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 如何解决冲突第 1 步打开冲突文件找到所有标记VS Code 等编辑器通常会自动高亮这些标记。第 2 步决定保留哪段代码手动编辑文件删掉所有标记符号、、。例如决定采用 5000同事的版本function login() { const url /api/login const timeout 5000 // 采纳同事的改动 return fetch(url, { timeout }) }第 3 步重新提交# 将冲突标记为已解决 git add login.js # 完成合并提交Git 会自动生成合并提交信息 git commit6.4 减少冲突的好习惯勤拉取开工前先同步最新代码避免落后太多小步提交不要攒一周的代码一次提交频繁的小提交更容易定位和解决冲突分支隔离不同功能用不同分支减少同一行代码的竞争及时沟通改动共享文件如config.js之前先跟同事打声招呼。7. 命令速查表原文档页面的GitCommandCheatsheet /交互组件以分类速查卡片的形式呈现下列命令这里整理成可随时查阅的表格场景命令说明初始化git init在当前目录创建仓库克隆git clone 地址完整拷贝远程仓库到本地状态git status查看当前分支与文件改动状态暂存git add 文件/git add .把改动放入暂存区提交git commit -m feat: ...把暂存区内容固化为一条历史记录历史git log/git log --oneline查看提交历史分支git branch列出所有分支* 为当前分支建分支git branch 名创建分支切分支git checkout 名切换分支建并切git checkout -b 名一步创建并切换推荐合并git merge 分支把指定分支合并进当前分支删分支git branch -d 名删除已合并的分支关联远程git remote add origin 地址关联远程仓库约定别名 origin查看远程git remote -v查看远程仓库关联信息推送git push/git push -u origin main上传本地提交到远程拉取git pull下载远程内容并合并fetch merge配置git config --global user.name/email设置提交作者信息暂存变更git stash临时保存未提交的改动便于切换任务8. 实战加入团队项目的完整流程这是你加入一个新团队或新项目时的标准流程——可以直接照抄# ① 第一天把项目克隆到本地仅一次 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: 完成用户资料编辑 API 对接 # ⑥ 把自己的分支推送到远程让同事能看到 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关于第 ⑦ 步的 PR 规范easy-vibe 仓库本身就是很好的范本AGENTS.md 约定 PR 应包含简短描述、UI 或组件变更的截图/GIF、以及涉及的路径如docs/zh-cn/appendix/...、docs/.vitepress/theme/...。这套流程提交规范 分支隔离 代码评审正是现代团队协作的标准形态。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 模板库创建仓库时可直接选用对应模板在 New repository 页面勾选 Add .gitignore 并从下拉列表中选择也可以在对应模板项目中检索适合自己技术栈的规则。10. 术语表术语英文解释仓库Repository (Repo)存放项目全部版本历史的数据库位于.git文件夹提交Commit一条完整的版本记录类似游戏存档带描述和时间戳分支Branch独立的开发线像互不影响的平行时间线合并Merge把一个分支的改动整合进另一个分支冲突Conflict同一行代码被多人修改Git 不知道该用哪个版本需要手动解决暂存Stage / Index把改动放入待提交清单的操作远程Remote仓库的云端副本GitHub / GitLab / Gitee克隆Clone把整个远程仓库完整拷贝到本地推送Push把本地提交上传到远程仓库拉取Pull下载远程最新内容并在本地合并HEADHEAD指向当前分支/提交的指针表示你现在在哪里originorigin远程仓库的默认别名约定俗成的名字stashStash临时保存未提交的改动切换任务时很有用PR / MRPull Request / Merge Request申请把自己的分支合并进主分支通常需要团队评审11. 在 easy-vibe 中继续深入本文定位是原理 核心命令当你准备真正动手建议接着阅读以下仓库内文档Git 实战篇Git 与 GitHub 使用入门——多平台安装、GitHub 账号注册、首次创建远程仓库、SSH 绑定、以及在 AI IDETrae中用自然语言完成 clone / pull / commit / push 的实操全流程是本文的实战延续SSH 认证安全通信——密钥对原理、ssh-keygen参数、SSH Config 别名与常见问题排查命令行与 Shell基础——Git 全部操作都发生在终端里掌握ls、cd、mkdir等基础命令是前提附录首页——easy-vibe 的完整知识库索引可以按需查阅网络、数据库、部署等其他主题。版本控制能力是 AI 原生开发者vibe coding的基本功无论你用 AI 生成了多少代码最终都要靠 Git 来管理版本、隔离实验、回归历史与团队协作。把本文的命令练熟再结合实战篇完成一次完整的克隆 → 建分支 → 提交 → 推送 → PR流程你就正式具备了现代开发者的协作基础设施。【免费下载链接】easy-vibe vibe coding 101The first course for AI-native product builders.项目地址: https://gitcode.com/GitHub_Trending/ea/easy-vibe创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考