坦白讲每次有同事或者新手朋友跑过来问我Git 到底怎么学我都建议他们别一上来就啃命令行先在 VS Code 里把 Git 玩明白。VS Code 内置的 Git 能力已经相当完整而且把所有关键操作都做成了可视化的按钮、面板和提示对新人来说这种“看得见的状态变化”比背一百条命令都管用。这篇教程就是照着菜鸟路线写的把你从“完全不知道 Git 是什么”带到“能独立用 VS Code 完成日常提交、分支合并、推送远程仓库”每一步都会告诉你为什么要这么做以及在哪里点鼠标。不管你是刚入行的开发者还是写论文、做实验需要管理多版本文件的学生这套流程都能直接照抄。1. 先搞清楚VS Code 内置 Git 到底能做什么1.1 从“敲命令”到“点鼠标”的转变很多人对 Git 的第一印象是黑色终端窗口里的一堆神秘命令git init、git add、git commit、git push。这些命令本身不难但对新手来说最痛苦的是没有“状态感”。你敲完git add .文件到底去哪里了你执行完git commit -m xxx刚才那个版本和自己改动的文件又是什么关系VS Code 解决的就是这个“状态可视化”的问题。左侧活动栏里的“源代码管理”图标点开之后你能直接看到当前仓库里所有被修改的文件被删除的文件新增的文件。每个文件前面都有一个字母标记U 表示未跟踪M 表示已修改D 表示已删除A 表示已暂存。这种图形化的呈现方式相当于给 Git 装上了一个仪表盘新手可以一边操作一边观察状态变化逻辑一下子就通了。1.2 内置功能已经够用不需要急着装插件VS Code 对 Git 的支持是开箱即用的只要电脑上装了 GitVS Code 就能自动识别并接管。内置功能包括但不限于查看和切换分支暂存、取消暂存文件提交代码拉取和推送远程仓库查看文件改动对比查看提交历史解决简单的合并冲突换句话说日常开发中 80% 的 Git 操作内置面板就完全够用了。很多人刚入门就到处找各种花哨插件其实不必要。插件只是锦上添花不是必需品。我个人的建议是先用内置功能把基础操作练熟等你真正理解 Git 的工作原理之后再根据自己的习惯去决定要不要装增强插件比如历史可视化、代码作者快速查看之类的工具。提示如果你打开 VS Code 之后发现“源代码管理”图标一直提示无法使用 Git那大概率不是编辑器的问题而是电脑里根本没装 Git。下一章就解决这个问题。1.3 哪些场景仍然需要命令行当然VS Code 的图形化界面也不是万能的。有些操作在界面上藏得比较深或者实现起来非常绕比如修改最近的提交信息合并多个提交处理复杂的变基操作初始化裸仓库高级的 Git 配置但这不意味着新手必须一上来就背命令。我的经验是初期用 VS Code 面板操作遇到面板不方便处理的极少数情况再打开 VS Code 内置终端敲对应命令。这样你既不恐惧 Git 命令也能逐步积累命令行知识过渡会非常自然。2. 环境准备装好 Git 并把 VS Code 配对2.1 安装 Git三个平台的落地步骤VS Code 是编辑器它本身只负责调用 Git。真正干活的是 Git 程序所以第一步必须装 Git。Windows去 Git 官网下载对应系统的安装包下载完直接一路默认安装即可。唯一需要注意的地方是安装过程中会有几个选择项比如默认编辑器选 VS CodePATH 环境变量选“Git from the command line and also from 3rd-party software”也就是推荐项。其他全部默认继续下一步就行。安装完成后在任意文件夹里点右键如果能看到“Open Git Bash here”这种菜单项就说明装好了。macOS如果你的电脑里装了 Homebrew可以直接在终端执行安装命令。如果没有也可以去 Git 官网下载 macOS 安装包双击安装过程比 Windows 还简单。Linux不同发行版命令不一样。基于 Debian 的发行版通常用系统自带的包管理器安装基于红帽系通常用另一个包管理器。这个对新手一般不是障碍因为你的开发环境大概率已经装好了。注意安装 Git 时建议保持默认的“checkout as-is, commit as-is”换行符选项。很多 Windows 新手习惯选成“checkout Windows-style, commit Unix-style”结果后面出现一堆“LF will be replaced by CRLF”警告自己还摸不着头脑。先按默认走减少干扰。2.2 首次运行必须做的两件事身份信息配置Git 每次提交都会把作者信息写入提交记录所以它必须知道你是谁。这一步不能省略否则提交会失败或者提交到一个错误的默认身份下。打开 VS Code 的终端菜单新建一个终端窗口输入git config --global user.name 你的名字 git config --global user.email 你的邮箱这里加--global是指对当前电脑上的所有 Git 仓库生效。建议这里填真实信息因为以后提交代码时会显示在历史记录里方便团队认出是谁提交的。如果想检查配置是否生效执行git config --global --list输出里如果能看到user.name和user.email就说明配置成功了。2.3 验证 VS Code 是否成功识别 Git配置完成后把 VS Code 完全关掉重新打开。然后在左侧活动栏上你应该能看到一个“源代码管理”的图标图标下面可能有一个数字角标表示当前工作区有多少个修改过的文件。此时如果没有打开的文件夹VS Code 会显示“打开文件夹”。随意打开一个项目文件夹点开“源代码管理”面板如果页面顶部显示“当前存储库”并列出文件或者显示“初始化存储库”按钮都说明 VS Code 已经识别到 Git。如果还是提示“无法访问”重新检查一下 Git 是否装好然后在命令面板里执行“重新加载窗口”。3. 从零开始初始化仓库并完成第一次提交3.1 创建项目目录并初始化仓库假设你现在有一个文件夹叫my-demo里面放着一个index.html或者readme.md。在 VS Code 里打开这个文件夹然后打开源代码管理面板点击“初始化存储库”。如果你更愿意用命令也可以打开终端执行git init执行完之后文件夹里会出现一个隐藏的.git目录。这个目录就是 Git 的“大脑”以后所有版本信息都存放在这里。不要手动改动.git里的内容默认情况下它也不会被纳入版本控制。3.2 认识工作区、暂存区、版本库这一步是整个 Git 概念里最容易让新手糊涂的地方我用一个生活化的类比来解释。你可以把 Git 仓库想象成三个盒子工作区就是你当前正在编辑的文件夹所有文件还没被记录。暂存区相当于打包台你把打算提交的文件从工作区放进这个暂存框里代表“这些文件我准备记录了”。版本库相当于仓库当你执行提交时暂存区里的文件就会被拍一张快照并永久保存进这个仓库。这个三盒模型非常重要。新手最容易犯的错误是以为“保存文件”就等于“提交了”其实改完文件后文件只是停留在工作区Git 根本还没记录它的新版本。你必须在源代码管理面板里点击那个带加号的按钮把文件“暂存”然后再点“提交”才算真正进入版本库。3.3 第一次提交的完整步骤与状态解读在 VS Code 的源代码管理面板里操作打开项目新建一个文件随便写点内容。这时源代码管理面板里会出现这个文件文件名前面标注着字母 U代表该文件未被 Git 跟踪。把鼠标移到文件那一行上右边会出现一个加号图标点击它文件会移入“暂存的更改”分组U 变成 A 或者图标变化说明它已经被暂存。在顶部的提交信息输入框里写一句说明比如“初始化项目添加首页文件”。点击输入框上方的“提交”按钮或者按快捷键完成第一次提交。提交完成后工作区会变干净源代码管理面板显示“更改”为空后面显示“0”。这就是一次完整的状态循环工作区修改 → 暂存 → 提交 → 干净工作区。如果想确认提交确实成功了点开“源代码管理”面板右上角的“提交于”或“查看提交历史”就能看到一条刚才的提交记录包含作者、时间、提交说明。3.4 别急着继续写先配好 .gitignore很多项目的目录里会有一堆无关紧要的文件比如系统生成的临时文件、日志、依赖包、本地环境配置。这些文件不应该提交进 Git。如果新手不管三七二十一全部提交仓库会越来越臃肿而且不小心还会把本地密码之类的敏感信息提交上去。解决办法是在项目根目录创建.gitignore文件把不需要纳入版本管理的规则写进去。一个.gitignore的常见片段# 依赖目录 node_modules/ # 编译产物 dist/ build/ # 日志文件 *.log # 环境变量文件通常包含密钥 .env # 系统文件 .DS_Store Thumbs.db # 临时目录 tmp/ temp/注意.gitignore本身的文件名以点开头没有扩展名。在 Windows 资源管理器里新建时可能会被要求输入两次文件名容易踩坑建议直接在 VS Code 里新建文件输入.gitignore即可。如果某些文件已经被 Git 跟踪再在.gitignore里写规则是不会生效的。这种情况下需要先把它们从 Git 的跟踪列表里移除然后再提交一次git rm -r --cached .gitignore 需要的文件名或目录这句命令是很多新手不知道的特此提一下。4. 分支多人协作的靠山4.1 为什么要分支分支这个概念可以类比成写小说时的“分稿”。主线版本平时保持稳定你想写一段大胆的新情节就复制一份稿子出来在拷贝上改改好了觉得效果不错再合并回去改砸了也不会影响主线。在团队协作里分支确保了每个成员的改动不会互相干扰。平时大伙儿各拉各的分支互不打扰做完功能再把分支合并回主干。没有分支的话你正在改 A 文件同事也在改 A 文件提交的时候就会不停打架。4.2 在 VS Code 里创建、切换、合并分支VS Code 里操作分支非常直观。看编辑器左下角的状态栏那里会显示当前分支名默认是main或者master。点击这个分支名字顶部会弹出一个命令面板里面有两个常用选项创建新分支输入一个有意义的分支名比如feature/login然后按回车。切换到已有分支在列表里选择目标分支按回车即可切换。分支创建并切换成功后左下角显示的分支名会变化。此后你在这个分支上的所有提交都不会影响主干分支这就是它的隔离作用。合并分支在两个分支都各自有提交之后是重头戏。假设你在feature/login分支上完成了登录功能想合并回主干先切换到主干分支main。再从源代码管理面板打开菜单选择“分支”然后“合并分支”。在弹出的列表里选择feature/login。如果两边没有冲突VS Code 会直接完成合并并显示一条成功提示。合并完成后feature/login分支的代码就进入main了。如果分支已经不需要保留可以顺手删除。经验切换分支前先确认工作区是干净的也就是没有未提交的改动。如果不干净分支切换有可能带着改动一起移动造成混乱。新手经常在这里翻车。稳妥做法是先提交当前分支的改动再切分支。4.3 冲突是怎么出现的以及如何处理冲突是新手最怕的事情其实它并不可怕。它在本质上就是两个分支都对同一个文件的同一处地方做了修改Git 不知道该听谁的只能把决定权交给你。亲身体验一个典型场景在main分支上把文件的某一行的文字改成“主线的内容”。提交这个改动。切到一个新分支把同一行文字改成“分支的内容”。提交这个改动。切回main分支尝试把新分支合并过来。这时 VS Code 源代码管理面板里会显示冲突文件文件旁边有字母 C打开文件后会看到 Git 插入的特殊冲突标记 HEAD 主线的内容 分支的内容 feature/xxx HEAD到之间是当前分支的内容到之间是待合并分支的内容。你需要决定保留哪一边或者两边都保留。在 VS Code 里冲突的每一行上方还会出现“采用当前更改”“采用传入更改”“保留双方更改”这类的快捷按钮点一下就能自动清理标记。选完内容后记得把文件保存然后再次点击暂存加号把这个文件标记为“已解决”最后再提交一次冲突就正式结束了。这个过程新手至少要完整跑几遍跑熟之后你就不会再害怕 Git 了。5. 和远程仓库打交道推、拉、克隆5.1 远程仓库到底是什么本地仓库只在你的电脑上如果电脑坏了、换了、或者想和团队共享就必须有一个远程仓库。你可以把远程仓库想象成一个所有人都能访问的中央服务器本地代码推上去别人就能拉下来。常见的代码托管平台有很多无论是哪个平台基本流程都差不多。你只需要在平台上“新建一个仓库”拿到仓库地址剩下的工作就在 VS Code 里完成。5.2 关联远程仓库HTTPS 与 SSH 的选择拿到远程仓库地址后通常会有两种协议可选HTTPS地址以https://开头首次推拉代码时需要输入用户名和访问令牌。SSH地址以git开头需要用 SSH 密钥做身份认证配置好之后不需要频繁输入密码。新手前期建议直接用 HTTPS 加访问令牌因为配置最简单。访问令牌怎么生成这个要看所用托管平台的具体选项一般在账号设置里找“访问令牌”或者“Personal Access Token”一类入口生成后复制保存。注意这个令牌只会显示一次一定要立刻保存到自己的密码管理工具里。SSH 的配置流程多一步需要在本地生成密钥对然后把公钥填到平台的 SSH 配置里。生成命令是ssh-keygen -t rsa -b 4096 -C 你的邮箱执行之后一路回车默认路径即可。生成完会在用户目录下出现.ssh目录里面有两个文件私钥id_rsa和公钥id_rsa.pub。把公钥文件的内容完整复制到托管平台的 SSH 密钥配置里。之后远程地址用 SSH 形式连接时就不会再让你输密码了。5.3 推送、拉取、克隆的完整流程在 VS Code 里关联远程仓库有三个入口如果你已经拿到了一个远程仓库的地址想把这个仓库的代码下载到本地可以直接打开源代码管理面板选择“克隆存储库”然后粘贴网址选一个本地保存目录VS Code 会帮你把整个仓库拉下来。如果你已经在本地初始化了仓库想让本地仓库和远程仓库建立联系需要先把远程地址添加为 remote。在终端里执行git remote add origin 你的远程仓库地址之后把本地的默认分支推送到远程在 VS Code 源代码管理面板选择“发布分支”或者执行git push -u origin main-u的意思是把当前分支和远程分支建立追踪关系之后执行git push或git pull都不用带参数。日常开发中每天开始工作前先拉取最新代码工作结束后推送自己的提交这是一个好习惯。在 VS Code 源代码管理面板的“...”菜单里会看到“拉取”“推送”两个常用选项。点击之前记得先提交本地改动否则拉取时可能会有阻碍。5.4 Pull Request / Merge Request 的协作姿势团队协作时不建议直接在主干分支上推来推去。更稳的流程是先创建自己的功能分支比如feature/payment。在这个分支上完成开发并提交。把该分支推送到远程仓库。在托管平台上发起一个“拉取请求”或者“合并请求”。等同事审查通过再由具备权限的人把分支合并到主干。这个流程看起来多绕了一圈但能够保证主干分支始终处于稳定状态。哪怕有人的改动出了问题也不会直接污染主干代码回滚起来非常方便。新手在做这个流程时最容易忘的一步是发起合并请求前先把自己的分支更新到和主干一致。因为在并行开发中主干可能已经前进了一大截。操作上建议先切到主干拉取远程最新再切回自己的分支把主干合并进来解决掉可能的冲突然后再推送发起合并请求。这套动作看起来啰嗦但能帮你避免大量协调成本。6. 新手最容易踩的 10 个坑与排查技巧6.1 中文文件名和提交信息乱码这个问题在 Windows 上尤其明显。配置文件里有两个选项可以改善乱码git config --global core.quotepath false git config --global gui.encoding utf-8设置完core.quotepath false之后中文文件名会正常显示而不是变成一串转义字符。如果提交信息里的中文在终端里显示乱码还有一种可能是终端编码问题在 VS Code 的终端设置里把默认编码调整为 UTF-8 基本能解决。乱码问题很难一句话说死但上面两个配置是最值得先试的。6.2 CRLF 与 LF 换行符告警Windows 文件默认用回车换行符而 Linux 和 macOS 默认用换行符。Git 检测到文件换行符不同时会提示 “LF will be replaced by CRLF” 这类警告。这个警告一般不会导致功能问题但会干扰新手。最稳妥的解决办法是统一执行git config --global core.autocrlf true这样 Windows 在检出代码时会自动转成 Windows 换行符提交时会自动转成 Unix 换行符团队协作不容易因为换行差异产生全文件差异。不同操作系统之间的换行问题是一个很经典的话题切换配置后最好重新克隆或者重新检出一次仓库。6.3 每次推送都要求输入密码很烦如果你用的是 HTTPS 地址每次推送都可能要输入用户名和令牌。解决方式是在系统仓库里启用凭据管理器。Windows 安装 Git 时默认会启用 Git Credential Manager一般首次输一次令牌就会记住。如果没记住可以手动启用git config --global credential.helper manager如果还是不生效八成是用错了令牌或者令牌过期。去托管平台重新生成一个访问令牌复制时注意别带空格。如果你更讨厌输密码就直接换成 SSH 方式的远程地址一次配置永久有效。6.4 提交错了文件或者想撤销本次改动新手最常犯的错是把不该提交的文件一起提交了。这里给你几个可用的命令按程度从小到大排列需求VS Code 操作 / 命令后果文件改了但不想保留改动点击文件旁撤销图标或git restore 文件名工作区文件恢复到最近提交状态已经把文件加入暂存区想取消点击文件旁的减号图标或git reset HEAD 文件名文件回到已修改状态已经提交但提交信息写错了git commit --amend -m 新信息修改最近提交的说明已经提交但想把提交撤销掉git revert 提交ID生成一次新的反向提交历史保留想彻底丢弃某次提交之后的所有改动git reset --hard 提交ID危险会丢失改动前三个操作都是安全的后两个要非常谨慎。特别是git reset --hard执行前务必确认提交ID没写错否则很难找回来。在新手阶段我宁可你多用几次git revert也别乱用git reset --hard。6.5 代码不小心提交到了主干分支这种情况高频发生。如果你在主干分支上提交了一个实验性的改动想把它挪到新分支上再继续开发操作逻辑是这样的先基于当前状态创建并切换到一个新分支。在主干分支上执行回退把主干恢复到原本的提交。切回新分支继续开发。这样一来实验改动就留在了新分支上主干分支恢复了干净状态。整个过程建议用命令行操作比较清楚VS Code 界面里也能做但新手容易在来回切换和暂存之间迷路。6.6 配置了 .gitignore 但文件还被跟踪前面提过.gitignore只对尚未被 Git 跟踪的文件生效。如果文件已经在历史中被跟踪过了再添加忽略规则是没用的。解决方式是把它们从索引中移除git rm -r --cached .这个命令会让 Git 认为所有文件都变成了未跟踪状态紧接着执行一次提交然后重新设置忽略规则之后再添加的新文件就会被.gitignore正确拦住。注意执行这句命令之后不要直接提交要先把需要保留的文件重新git add一次否则你的提交会变成删除所有文件。6.7 分支切换后代码“消失”了很多新人会遇到一个情况在 A 分支上写的代码切到 B 分支之后不见了。其实不是代码消失而是 Git 的工作区状态随分支变化而变化。解决方案也很简单切回 A 分支就能看到之前的代码。如果是已经提交过的内容一定不会丢如果是未提交的改动切换分支时会被携带或阻止取决于是否有冲突。这条问题我见过太多次所以特地放在这里养成“先提交再切分支”的习惯几乎能避免所有“代码消失”类恐慌。6.8 想对比文件改了什么VS Code 的源代码管理面板里点击任意一个被修改的文件编辑器会自动打开一个 diff 视图左侧是旧版本右侧是新版本改动的地方会用不同背景色标出来。这个能力非常实用提交前快速扫一遍 diff能帮你发现很多不小心改错的内容。我强烈建议每次提交之前都习惯了先看 diff 再提交。6.9 提交历史里的提交信息写得一塌糊涂提交信息是给未来的人看的包括几个星期后的自己。格式建议参考常规语义一行内容不要超过 50 个字符动词开头比如fix: 修复登录按钮无法点击。如果某次提交信息写得太差而提交还没有推送到远程你可以直接改最近一次提交的信息如果已经推送了强制修改历史就不要再做了以免影响协作者。6.10 远程有更新本地无线索推送被拒绝推送时提示“远端有更新推送被拒绝”是正常现象意思是远程仓库更新的提交包含你和别人都有交集的历史Git 不允许你覆盖别人的部分。正确做法是先拉取git pull --rebase origin main这里--rebase的意思是把你的本地提交放到远程更新之后让历史变成一条整洁的直线。如果你更习惯可视化操作在 VS Code 里直接点拉取也可以只是结果可能是产生一个合并提交历史会多出一个分叉节点。新手期两种方式都可以接受只要能解决实际问题就行。7. 把高频操作练成肌肉记忆我的个人心得带过几个人之后我发现把所有 Git 操作都背下来不如只练熟那么几个高频操作。你真正每天要用的其实有限拉取、开关分支、暂存、提交、推送、解决冲突。把这些操作练到不看教程也能完成就已经超过了大多数人。这里再送你一个我个人现在还在用的小习惯每天开工第一件事打开 VS Code 源代码管理面板先看有没有没提交的改动然后点右下角的状态栏分支名拉取远程最新代码。每天下班前再看一眼 diff把改动的代码提交并推送。坚持两周你会发现 Git 从一门“课程”变成了一个“工具”。最后分享一个踩坑经验别在还没写完的功能分支上频繁合并主干也别在自己本地分支上堆积大量未提交的改动。每次只做一件事做完就提交。这种节奏会让你的 Git 操作异常简单因为 Git 本来就是为“小而清晰的提交”设计的。等提交历史变成一长串有逻辑的小提交时你回头看它会有一种非常踏实的掌控感。