VSCode+Git+Azure DevOps 零门槛全流程教程 | 小白可直接上手 初始化/分支切换/提交/合并全解

前言

本文专为零基础小白打造，全程提供可视化界面操作（优先推荐，无需记命令）+终端命令双方案，每一步都附带大白话作用解释，从环境准备、仓库初始化，到文件修改、分支切换、云端推送、PR合并，全流程无死角覆盖，跟着做就能一次性跑通完整流程。

同时会深度解析Git初始化的核心作用，帮你不仅会操作，还能懂原理，彻底告别复制命令却不知道在干嘛的窘境。

本文所有操作均兼容Windows/Mac系统，适配企业级Azure DevOps团队协作规范，可直接用于日常开发工作。

一、前置准备（小白必做，一步都不能少，否则流程必报错）

1.1 必备软件&账号安装注册

1.2 一次性Git全局配置（仅需做一次，永久生效）

1. 打开VSCode→顶部菜单【终端】→【新建终端】，调出终端面板
2. 输入以下2条命令，把引号内容替换为自己的信息，每条输完按一次回车执行

   gitconfig--globaluser.name"你的用户名（建议和Azure账号一致）"gitconfig--globaluser.email"你的Azure注册微软邮箱@xxx.com"

3. 验证是否成功：输入git config --global --list，能看到刚设置的name和email即为配置成功
4. 作用解释：Git每次提交都会记录提交人信息，该配置会告诉Git你的身份，Azure DevOps也会通过该邮箱匹配你的账号，否则提交记录无法关联到你的Azure账号。

1.3 小白必懂的4个核心Git概念（大白话无术语版）

• 工作区：你在VSCode里直接编辑、修改的文件，改完仅保存在电脑本地，Git未做任何记录，相当于你正在写的草稿
• 暂存区：临时存放你要提交的修改，相当于“打包准备发货的快递箱”，可灵活选择要提交的文件
• 本地仓库：你电脑里的Git仓库，所有提交记录都存储在这里，相当于“你家的储物柜”，只有提交到这里，Git才会永久保存你的修改，生成可回溯的版本记录
• 远程仓库：Azure DevOps上的云端仓库，相当于“团队共享的云端网盘”，所有人的最终代码都在这里汇总

二、核心全流程分步操作（双方案全覆盖）

分两种高频工作场景，小白按需选择即可：

• 场景A：本地已有文件夹/文件，需初始化并上传到Azure DevOps
• 场景B：Azure DevOps已有仓库，需克隆到本地直接开始修改

场景A：本地文件初始化→关联Azure→全流程操作

2.1 步骤1：本地仓库初始化（git init）| 核心作用深度解析

【可视化操作（小白优先推荐）】

1. 在电脑上新建一个空文件夹（路径绝对不能有中文、空格、特殊符号，小白切记！），把需要管理的文件全部放入该文件夹
2. 打开VSCode→左上角【文件】→【打开文件夹】，选中刚创建的文件夹并打开
3. 点击左侧【源代码管理】图标（三个点连起来的分叉图标，快捷键Ctrl+Shift+G），点击面板里的初始化仓库按钮，1秒即可完成

【终端命令操作】

打开VSCode终端，直接输入以下命令，按回车执行

gitinit

【核心作用解释（小白必看）】

git init的核心作用，是把你的普通文件夹，变成一个Git能识别、管理的本地仓库。

• 执行前：这只是个普通文件夹，你修改、删除文件，Git完全无感知，没有任何版本记录，文件误删无法找回
• 执行后：Git会在文件夹里生成一个隐藏的.git目录，这个目录是Git的“核心数据库”，会记录该文件夹里所有文件的每一次修改、提交、分支变化。从此该文件夹就具备了完整的版本控制能力，所有Git操作都只能在Git仓库中执行。
• 关键提醒：如果你的文件夹是从Azure克隆下来的，绝对不要重复执行git init，克隆时已自动完成初始化。

2.2 步骤2：关联Azure DevOps远程仓库

【操作步骤】

1. 打开Azure DevOps网页，进入你的项目→【Repos】→【文件】，点击右上角克隆按钮，复制仓库的HTTPS地址（小白不要选SSH，HTTPS最简单）
2. 回到VSCode终端，输入以下命令，把引号里的地址替换为刚复制的Azure仓库地址，按回车执行

   gitremoteaddorigin"你复制的Azure DevOps仓库HTTPS地址"

3. 验证是否关联成功：终端输入以下命令，执行后能看到两行origin开头的地址，和你复制的地址一致，即为关联成功

   gitremote-v

【作用解释】

该命令是给你的本地Git仓库，绑定一个云端远程仓库地址（Azure上的仓库），并给这个远程仓库起了行业通用的默认别名origin。关联之后，本地仓库和Azure云端仓库就建立了连接，后续才能把本地文件推送到云端，也能从云端拉取别人的代码。

2.3 步骤3：拉取Azure云端仓库的基础内容（避坑必做，否则会报冲突）

【操作步骤】

终端输入以下命令，按回车执行，执行后会弹出Azure登录窗口，用你的微软账号登录即可

gitpull origin main --allow-unrelated-histories

• 注意：如果你的Azure仓库默认主分支是master，就把命令里的main换成master

【作用解释】

git pull的作用是把Azure云端仓库里的所有文件、提交记录，拉取到你的本地仓库，让本地和云端保持初始同步。

• 小白必做：如果Azure仓库里已有README.md、.gitignore等文件，不拉取的话，后续推送会直接报错“历史不匹配/冲突”；就算是空仓库，执行该命令也能验证远程连接、登录是否正常。
• --allow-unrelated-histories是小白专属参数，专门解决本地初始化的仓库和云端仓库历史不匹配的报错，仅第一次拉取需要添加，后续无需添加。

2.4 步骤4：切换到Azure DevOps对应分支，创建&关联远程分支

🚩企业开发铁律：绝对不能直接在main主分支上修改文件！必须新建自己的分支，修改完再合并到主分支，避免搞坏主代码，小白一定要严格遵守！

场景A1：Azure远程仓库已有目标分支，需切换到该分支工作

1. 先刷新远程分支列表，终端输入：

   gitfetch origin

   作用：把Azure云端所有最新的分支信息同步到本地，让本地知道云端有哪些分支，相当于“刷新通讯录”
2. 切换到目标远程分支，同时创建本地分支并自动关联远程，终端输入：

   gitcheckout-b本地分支名 origin/远程分支名

   示例：远程分支叫dev，就输入git checkout -b dev origin/dev
3. 可视化操作：点击VSCode左下角的分支名称，在弹出的列表里直接选择目标远程分支，一键切换并创建本地关联分支
4. 验证：VSCode左下角会直接显示你当前所在的分支名，即为切换成功

场景A2：Azure远程仓库无目标分支，需新建本地分支并同步到云端

1. 先切回主分支，拉取最新代码，确保你的新分支是基于最新主分支创建的，避免后续合并冲突

   gitcheckout maingitpull origin main

2. 新建并切换到本地新分支，终端输入：

   gitcheckout-b你的新分支名

   命名规范：不要用中文，建议用英文/拼音，比如修改文档起名feature/doc-update，修复bug起名bugfix/xxx-fix
   可视化操作：点击VSCode左下角的分支名→选择【创建新分支】→输入分支名→按回车，一键创建并切换
3. 把新分支推送到Azure云端，创建对应的远程分支并永久绑定关联

   gitpush-uorigin 你的新分支名

   示例：git push -u origin feature/doc-update
4. 作用解释：-u origin 分支名这个参数会把你的本地分支和Azure云端的同名分支做永久绑定，后续执行git push、git pull时，无需再写分支名，直接执行命令即可，小白一定要添加该参数。
5. 验证：去Azure DevOps网页的【Repos】→【分支】里，就能看到你刚创建的分支。

2.5 步骤5：本地文件新增/修改，暂存更改

1. 现在你在自己的分支上，可以正常操作了：
   • 新增文件：VSCode左侧资源管理器右键→新建文件，比如新建README.md、代码文件等
   • 修改文件：直接打开文件编辑，修改完成后按Ctrl+S保存
2. 保存后，左侧【源代码管理】图标上会出现数字，代表有多少个文件被修改了
3. 暂存更改（把修改放进“快递箱”），可视化操作优先：
   • 点击左侧【源代码管理】，看到“更改”列表里的修改文件，鼠标放到文件上，点击后面的**+**号，即可暂存单个文件
   • 如果要暂存所有修改，点击“更改”右边的**+**号，一键暂存全部
4. 命令操作（可选）：

   gitadd.# 暂存当前目录所有修改的文件gitadd文件名# 暂存单个指定文件

【作用解释】

暂存的核心作用，是让你灵活选择要提交的内容。比如你改了10个文件，只想提交其中5个，就可以只暂存这5个，不会把所有修改一股脑提交上去。

2.6 步骤6：提交更改到本地Git仓库

1. 暂存完成后，在【源代码管理】面板的顶部“消息”输入框里，必须写提交备注，比如“新增项目说明文档”“修复XX文件错别字”，一定要写清楚，不能为空！
2. 写完备注后，点击输入框下面的提交按钮，即可完成本地提交
3. 命令操作（可选）：

   gitcommit-m"你的提交备注，必须写在引号里"

【作用解释】

git commit的核心作用，是把暂存区里的修改，永久提交到你的本地Git仓库，生成一条唯一、不可篡改的提交记录（游戏存档点）。

• 每一次commit，都会生成一个专属版本号，Git会记录这次提交改了什么、谁改的、什么时候改的，以后你想回退到任何一个历史版本，都可以通过这个提交记录找到。
• 重点提醒：commit只是提交到了你的本地仓库，Azure云端仓库里还没有这些修改，必须执行下一步push，才能同步到云端。

2.7 步骤7：推送本地提交到Azure DevOps远程仓库

1. 提交完成后，【源代码管理】面板会显示“你的分支领先origin/xx分支x个提交”，意思是本地有新提交还没推送到云端
2. 可视化操作（推荐）：直接点击【源代码管理】面板顶部的同步更改按钮，或者推送按钮，一键推送
3. 命令操作（可选）：因为之前已经用-u绑定了远程分支，直接输入以下命令即可

   gitpush

4. 验证：执行成功后，去Azure DevOps网页的【Repos】→【文件】，切换到你的分支，就能看到你刚提交的文件和修改内容了！

【作用解释】

git push的核心作用，是把你本地仓库里的所有新提交记录，同步推送到Azure DevOps的云端远程仓库。

• 执行后，你的文件就从本地上传到了云端，团队里的其他人就能从云端拉取到你的修改，同时也做了云端备份，就算你电脑坏了，云端的代码也不会丢失。
• 小白铁律：推送前一定要先执行git pull拉取最新代码！如果别人在你修改的同时，也改了同一个分支的代码，不pull就push会直接报错冲突。

场景B：直接克隆Azure已有仓库到本地，快速开始

如果Azure DevOps已经有完整的仓库，直接用这个方案，跳过初始化、关联步骤，更简单。

1. 打开Azure DevOps仓库，点击【克隆】，复制HTTPS地址
2. 打开VSCode，按快捷键Ctrl+Shift+P调出命令面板，输入Git: 克隆，按回车
3. 粘贴你复制的Azure仓库地址，按回车，选择你要存放仓库的本地文件夹
4. 等待克隆完成，弹窗里选择【在新窗口中打开】，直接打开仓库
5. 后续的分支切换、文件修改、暂存、提交、推送，和场景A的步骤2.4-2.7完全一致
6. 补充说明：克隆操作会自动帮你完成仓库初始化、远程仓库关联，不需要再执行git init和git remote add命令。

三、Azure DevOps PR拉取请求创建&代码合并全流程

🚩企业开发铁律：绝对不能直接把代码push到main主分支！几乎所有企业都会设置主分支保护，必须通过PR（拉取请求），经过审核后，才能合并到主分支，小白一定要严格遵守这个规范。

3.1 网页端创建PR（小白首选，可视化无门槛）

1. 把你的分支代码push到Azure云端后，Azure DevOps网页会直接弹出“创建拉取请求”的提示，直接点击即可；如果没弹出，就手动进入【Repos】→【拉取请求】→点击【新建拉取请求】
2. 填写PR核心信息：
   • 源分支：选择你自己的分支（刚推送代码的分支）
   • 目标分支：选择你要合并到的分支，一般是main主分支
   • 标题：写清楚这个PR的核心内容，比如“新增项目说明文档”
   • 说明：详细写清楚你改了什么、为什么改，方便审核人查看
3. 填写完成后，点击【创建】，即可生成PR
4. 代码审核：把PR链接发给团队审核人，审核人查看代码无问题后，会批准PR
5. 合并代码：审核通过后，点击PR页面的【完成】按钮，弹出的窗口里，合并类型选“合并”，点击【完成合并】，即可把你的分支代码合并到main主分支！
6. 合并完成后，可以删除你自己的功能分支，保持仓库整洁。

3.2 VSCode内直接操作PR（进阶，无需切换网页）

安装了Azure Repos扩展后，点击VSCode左侧的【Azure】图标，就能看到你的Azure DevOps项目，在里面可以直接查看、创建、审核、合并PR，全程在VSCode内完成，无需切换浏览器。

3.3 PR核心作用&团队协作规范

PR（拉取请求）的核心作用，是发起一个“代码合并申请”，让团队成员审核你的代码，确保代码没有问题之后，再合并到主分支。既避免了有问题的代码搞坏主分支，也能通过代码评审提升代码质量，是团队协作的核心规范。

四、小白高频踩坑问题&解决方案

4.1 代码冲突了怎么办？

• 冲突原因：你和别人同时修改了同一个文件的同一行代码，Git不知道该保留谁的，就会报冲突
• 解决方法：
  1. VSCode会自动标红冲突的文件，打开文件，会看到冲突标记：

     <<<<<<< HEAD 你的代码 ======= 别人的代码 >>>>>>> 分支名

  2. 手动编辑文件，选择要保留的代码，删掉所有的冲突标记（<<<<<、=====、>>>>>这些符号）
  3. 保存文件，重新暂存、提交、推送即可

4.2 想回退到之前的版本怎么办？

1. 先查看提交记录：终端输入git log，就能看到所有的提交记录，每个记录前面有一串commit哈希值（版本号），复制你要回退的版本号
2. 回退命令：git reset --hard 你复制的版本号，执行后就回退到对应的版本了
3. ⚠️小白警告：--hard参数会删掉回退版本之后的所有修改，一定要谨慎使用！

4.3 登录失败/推送失败排查

1. 检查Git是否安装正确：终端输入git --version，能看到版本号即为安装成功
2. 检查远程地址是否正确：git remote -v查看地址是否和Azure上的一致
3. 重新登录：Windows在凭据管理器里删除Azure DevOps的凭据，重新执行git pull，会弹出登录窗口，重新登录即可
4. 自动登录失败：用PAT个人访问令牌登录，Azure DevOps右上角用户设置→【个人访问令牌】→新建令牌，权限勾选【Code(读写)】，复制生成的令牌，登录时用户名随便填，密码填这个令牌即可。

4.4 日常操作必守铁律

1. 每次修改代码前，先切换到自己的分支，执行git pull拉取最新代码
2. 绝对不直接在main主分支上修改、提交代码
3. 提交备注一定要写清楚，方便后续回溯和团队协作
4. 推送前先拉取，避免冲突

五、小白极简Git命令速查表

结语

本文完整覆盖了VSCode对接Git和Azure DevOps的全流程，从零基础环境准备，到团队协作的完整闭环，所有操作都经过实测，小白跟着做就能一次性跑通。

Git和Azure DevOps的核心是版本控制和团队协作，不用死记硬背命令，先跑通流程，再慢慢理解每个操作的原理，很快就能熟练掌握。