上手 Git：VSCode + Gitee 实战指南

实际指令如下：

git config --global user.name "Your Name"
git config --global user.email "[email protected]"

测试是否设置成功，在 Git Bash 中输入：

如果显示了你的名字就说明配置好了。

创建远程仓库并获取地址

在 Gitee 上新建一个仓库。注意不要勾选「使用 Readme 文件初始化仓库」，否则后面推送可能会冲突。

创建后会得到一个类似 https://gitee.com/你的用户名/仓库名.git 的地址，后面要用。

登录 Gitee 后进入个人工作台：

安装 VSCode（Windows）

下载与安装

去 VSCode 官方下载页 下载 Windows 64 位安装包，然后双击安装。

安装时务必勾选这几项：

• ☑ 创建桌面快捷方式
• ☑ 将'通过 Code 打开'添加到文件/文件夹右键菜单
• ☑ 添加到 PATH（重启后生效）

建议把安装目录改到非 C 盘。

基础配置

装好之后先切中文。按 Ctrl+Shift+P 打开命令面板，输入 "Configure Display Language"，选「Install Additional Languages...」，找到 Chinese (Simplified) 安装，重启。

然后装几个插件：点击左侧扩展图标（Ctrl+Shift+X），搜索安装：

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

再去设置（左下角齿轮）里调两个地方：

• Auto Save 设为 afterDelay（自动保存）
• Font Size 改为 16（看着舒服些）

常用技巧：终端里进到项目文件夹，输入 code . 可以直接用 VSCode 打开当前目录；Ctrl+ 打开内置终端。

在 VSCode 中使用 Git

安装插件

在扩展里搜 Git 相关插件，这里推荐 Git History 和一个图标插件（可选），方便查看状态栏变化。

配置用户信息（如果之前没做过）

在终端里执行：

git config --global user.name "Your Name"
git config --global user.email "[email protected]"
git config --list  # 检查配置

本地仓库基本操作

初始化仓库：

mkdir git-demo
cd git-demo
git init

添加文件并提交：

touch README.md
echo "# Git 教程演示项目" > README.md
git status           # 看到文件状态为 Untracked
git add README.md    # 或者 git add . 添加所有
git status           # 现在应显示 Changes to be committed
git commit -m "初始化项目，添加 README.md"

git status 是新手最常用的命令，随时查看当前状态。提交信息尽量写清楚改了啥，不要只写'修改'。

关联远程仓库并推送

先用 git remote add 关联之前创建的 Gitee 仓库：

git remote add origin https://gitee.com/你的用户名/仓库名.git

首次推送需要绑定分支并输入凭证：

git push -u origin main

这时会弹出 Gitee 登录窗口，或者在终端里提示输入用户名和密码。注意：这里密码要用前面生成的私人令牌，不是登录密码！ 否则会认证失败。

去 Gitee 仓库页面刷新一下，应该能看到刚推送的文件了。

后续提交后，只需要：

git push

拉取和克隆

当远程仓库有别人更新的代码时，用 git pull 拉下来：

git pull origin main

如果本地有未提交的修改，Git 会尝试合并；如果有冲突，需要手动解决。

全新参与项目直接克隆：

git clone https://gitee.com/用户名/仓库.git
cd 仓库
git pull  # 克隆后自动关联了远程，可直接拉取最新

常见问题

• 认证失败：检查私人令牌是否正确，是否勾选「repo」权限；仓库地址别写错。
• 推送报 non-fast-forward：说明本地落后于远程，先 git pull origin main 再 git push origin main。
• 刚创建的仓库推送报错：如果仓库初始化时不小心勾选了 README，可以先 git pull origin main --allow-unrelated-histories 强行合并，再推送。

简单总结

1. 环境：装好 Git → 注册 Gitee 生成私人令牌 → 本地配置用户信息。
2. 本地实操：git init → git add → git commit 形成工作闭环。
3. 远程协同：git remote add 关联 → git push -u origin main 首次推送 → 后续 git push/git pull。
4. 遇到认证问题查私人令牌，推送冲突先拉取。

记住这些，日常小项目已经够用了。