Git 零基础实战：Vscode + 码云配置与操作指南

前言

Git 是目前最主流的分布式版本控制系统，能帮我们追踪代码修改记录、多人协作开发、回滚错误版本，是程序员必备技能。本文从零基础开始，一步步带你掌握 Git 的核心操作，所有命令均可直接在终端执行，新手也能轻松上手。

前期准备（基础环境搭建）

需要事先安装 Git 及相关开发工具。

安装 Git

首先需要在本地安装 Git，不同系统的安装方式如下：

• Windows：访问 Git 官网 下载安装包，一路默认安装（建议勾选「Git Bash Here」，方便右键打开终端）；
• Mac：通过 Homebrew 安装（终端执行 brew install git），或直接从官网下载安装包；
• Linux（Ubuntu/Debian）：终端执行 sudo apt-get install git。

安装过程一直点下一步即可，建议不要安装在 C 盘。安装完成后使用 cmd 测试是否安装成功。

验证安装是否成功

# 查看 Git 版本，显示版本号即安装成功
git --version
# 示例输出：git version 2.43.0 (Apple Git-143)

码云账号注册

申请私人令牌

接下来申请一个私人令牌，用来做上传代码时个人认证的密码（请自己留存好，不要泄漏）。

打开个人设置

设置你的 git 账号信息

之后打开 cmd，设置你的 git 账号信息。

复制指令到 cmd 执行

测试设置

之后打开 git-bash（在你安装 git 的文件夹里，测试是否设置成功）。

显示名字则说明设置成功。

新建 Git 仓库并复制仓库地址

登录 Gitee

注册完成后登录自己的账号，进入个人工作台。

接下来我们使用 gitee，先打开 gitee 官网注册一个账号 https://gitee.com/。

安装 Vscode（Windows 版）

Windows 版 VSCode 安装 + 基础配置（精简版）

1. 下载安装包

• 访问 VSCode 官方下载页：https://code.visualstudio.com/Download
• 点击「Download for Windows」下载 64 位安装包（默认适配 Win10/11 主流系统）。

2. 安装 VSCode（关键选项必勾）

1. 双击下载的 exe 文件，同意协议后点击「下一步」；
2. 自定义安装路径（建议非 C 盘，如 D:\Software\VSCode），点击「下一步」；
3. 必勾核心选项：
   • ☑ 创建桌面快捷方式
   • ☑ 将'通过 Code 打开'添加到文件 / 文件夹右键菜单
   • ☑ 添加到 PATH（重启后生效）
4. 点击「安装」，完成后勾选「运行 VSCode」并点击「完成」。

3. 基础配置（新手必做）

（1）切换中文界面

1. 按下 Ctrl+Shift+P 打开命令面板；
2. 输入「Configure Display Language」回车，选择「Install Additional Languages...」；
3. 找到「Chinese (Simplified)」安装，重启 VSCode 自动切换中文。

（2）安装核心插件

点击左侧「扩展」（快捷键 Ctrl+Shift+X），搜索安装 3 个必备插件：

• Prettier - Code formatter：自动格式化代码
• Git History：可视化 Git 提交记录
• Code Runner：一键运行代码

（3）基础优化

打开左下角「设置」（齿轮图标），搜索调整 2 个关键项：

• 「Auto Save」选「afterDelay」（开启自动保存）；
• 「Font Size」调整为 16（提升编码可读性）。

4. 实用小技巧

• 右键文件 / 文件夹→「通过 Code 打开」，快速启动；
• 终端进入目标文件夹，执行 code . 直接打开该目录；
• 快捷键 Ctrl+`` 打开内置终端，Ctrl+Shift+P` 打开命令面板（万能入口）。

总结

1. 安装时务必勾选「添加到 PATH」和右键菜单选项，是提升使用效率的关键；
2. 新手优先配置中文界面 + Prettier 插件，满足基础编码需求；
3. 熟记 code .（终端打开文件夹）、Ctrl+Shift+P（命令面板）两个核心操作。

vscode 使用 git

1. 下载插件

2. 新建一个 vue 文件

用 VSCode 打开项目，打开终端，如果没有终端的同学可以点击菜单栏的查看——终端。

1. 配置用户信息（首次使用必做）

Git 需要关联用户名和邮箱，用于标识提交记录的作者（建议与 GitHub/Gitee 等平台账号一致）：

# 配置全局用户名（替换为你的名字）
git config --global user.name "Your Name"
# 配置全局邮箱（替换为你的邮箱）
git config --global user.email "[email protected]"
# 验证配置是否生效
git config --list
# 输出中能看到 user.name 和 user.email 即为配置成功

关键说明：--global 表示全局配置（所有本地仓库共用）；若想为单个仓库配置不同信息，去掉 --global，进入对应仓库目录再执行命令即可。

本地仓库基础操作（核心入门）

这是 Git 最基础的本地版本管理，核心流程：「初始化仓库 → 添加文件到暂存区 → 提交版本」。

初始化本地 Git 仓库

先创建项目文件夹，再将其初始化为 Git 可管理的仓库：

# 1. 创建项目文件夹（示例：git-demo）
mkdir git-demo
# 2. 进入该文件夹
cd git-demo
# 3. 初始化 Git 仓库（生成隐藏的.git 目录，存储版本信息）
git init
# 示例输出：Initialized empty Git repository in /Users/xxx/git-demo/.git/

关键说明：git init 仅需执行一次，执行后该文件夹就成为 Git 仓库。

添加文件到暂存区

Git 的版本管理分为「工作区→暂存区→版本库」三层，修改文件后需先添加到暂存区，才能提交到版本库：

# 1. 在 git-demo 中创建测试文件（示例：README.md）
touch README.md
# 2. 编辑文件内容（也可手动编辑）
echo "# Git 教程演示项目" > README.md
# 3. 查看文件状态（新手高频命令，必用）
git status
# 输出提示："Untracked files: README.md" → 该文件未被 Git 追踪
# 4. 将文件添加到暂存区
git add README.md
# 若要添加所有修改的文件：git add .（. 表示当前目录所有文件）
# 5. 再次查看状态，提示 "Changes to be committed" → 已进入暂存区
git status

小技巧：若添加错文件，执行 git rm --cached 文件名 可从暂存区移除（不会删除本地文件）。

提交版本（生成历史记录）

暂存区的文件需提交到版本库，才会生成永久的版本记录，提交时必须写清晰的提交信息：

# 提交暂存区文件到版本库，-m 后跟提交信息（必填）
git commit -m "初始化项目，添加 README.md"
# 示例输出：
# [main (root-commit) 8a7b6c9] 初始化项目，添加 README.md
# 1 file changed, 1 insertion(+)
# create mode 100644 README.md
# 查看提交历史（关键命令）
git log
# 简化日志输出（只显示哈希值前 7 位 + 提交信息）：
git log --oneline

提交规范：提交信息建议简洁明了，如「修复登录功能 bug」「新增用户列表页面」，避免无意义的「修改文件」。

阶段 3：远程仓库协作（本地→云端）

首次推送（需绑定默认分支）

# 首次推送必须指定分支（main 是 Git 默认分支，旧版本可能为 master），-u 表示绑定默认推送分支
git push -u origin main

3.2 登录验证（首次推送必现）

执行推送命令后，会弹出 Gitee 登录窗口（或 Git Bash 中提示输入账号密码）：

1. 方式 1：窗口登录（推荐）：在弹出的登录框中输入 Gitee 手机号 / 用户名 + 密码，点击「登录」；

方式 2：终端输入：若未弹出窗口，Git Bash 会提示：

Username for 'https://gitee.com': 你的 Gitee 用户名/手机号
Password for 'https://你的用户名@gitee.com': 你的 Gitee 登录密码

常见问题：密码输入后提示「认证失败」

原因：Gitee 从 2021 年起，禁止直接使用登录密码通过 HTTPS 方式推送代码，需使用「私人令牌」替代密码。解决步骤： ① 登录 Gitee，点击右上角头像→「设置」→「私人令牌」→「生成新令牌」； ② 勾选令牌权限：至少勾选「projects（仓库权限）」下的「repo」（仓库读写）； ③ 填写令牌描述（如「git 推送令牌」），点击「生成」，输入 Gitee 登录密码验证； ④ 复制生成的令牌（仅显示一次，务必保存）； ⑤ 回到 Git Bash，重新执行推送命令，密码处输入该「私人令牌」即可。

3.3 验证推送结果

推送成功的终端输出示例：

Enumerating objects: 3, done.
Counting objects: 100% (3/3), done.
Writing objects: 100% (3/3), 217 bytes | 217.00 KiB/s, done.
Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
To https://gitee.com/你的用户名/git-demo.git
* [new branch] main -> main
Branch 'main' set up to track remote branch 'main' from 'origin'.

刷新 Gitee 仓库详情页，能看到本地提交的文件（如 README.md），说明推送成功。

3.4 后续推送（简化操作）

首次推送绑定默认分支后，后续本地提交代码只需执行：

# 无需指定分支，直接推送
git push

阶段 4：从 Gitee 拉取代码（协作同步）

当团队成员修改了 Gitee 远程仓库的代码，你需要将最新代码拉取到本地，保持同步：

4.1 基础拉取命令

# 确保在本地 main 分支（默认分支）
git checkout main
# 拉取 Gitee 远程 main 分支的最新代码
git pull origin main

4.2 拉取场景说明

• 若本地无未提交的修改：拉取后直接同步远程代码，终端提示「Already up to date.」（已最新）或显示更新的文件；
• 若本地有未提交的修改：Git 会自动尝试合并代码，若合并无冲突，直接同步；若有冲突，需先解决冲突（参考 Git 分支合并冲突步骤）。

4.3 克隆远程仓库（全新协作场景）

若你是首次参与项目，无需本地初始化仓库，直接克隆 Gitee 远程仓库到本地：

# 克隆远程仓库到本地（会自动创建同名文件夹）
git clone https://gitee.com/你的用户名/git-demo.git
# 进入克隆后的仓库目录
cd git-demo
# 克隆后已自动关联远程仓库，可直接拉取/推送
git pull
# 拉取最新代码

阶段 5：常见问题及解决

问题 1：拉取 / 推送时提示「拒绝访问」

• 原因：账号无仓库权限、私人令牌过期 / 权限不足、仓库地址错误；
• 解决：
  1. 检查仓库地址是否正确（对比 Gitee 仓库的 HTTPS 地址）；
  2. 确认账号是仓库的所有者 / 协作者（Gitee 仓库→「管理」→「协作者」查看）；
  3. 重新生成私人令牌，确保勾选「repo」权限。

问题 2：推送时提示「non-fast-forward」

• 原因：本地分支落后于远程分支（他人已推送新代码，你未拉取）；
• 解决：先拉取远程最新代码，合并后再推送：

git pull origin main
git push origin main

总结

1. Gitee 协作核心流程：注册账号→创建远程仓库→本地关联（git remote add）→首次推送（git push -u origin main，需私人令牌验证）→后续推送 / 拉取（git push/git pull）；
2. 关键细节：首次推送需用「私人令牌」替代登录密码，仓库创建时不要初始化 README 文件（避免与本地冲突）；
3. 协作场景：全新参与项目用 git clone 克隆仓库，同步代码用 git pull，推送本地修改用 git push。