VSCode 使用 Git 快速提交代码指南

实用提示：如果误暂存，可点击暂存区文件旁的 回退按钮 取消暂存。

4. 编写提交信息

在源代码管理面板顶部的消息框中，输入本次提交的说明。

推荐格式：简洁明了，例如'修复 bug：xxx'或'新增功能：xxx'。

5. 提交代码

方式一：点击消息框右侧的'√'按钮。

方式二：使用快捷键 Ctrl+Enter（Windows/Linux）或 Cmd+Enter（Mac）。

提交后，代码将保存到本地 Git 仓库。

注意：提交前要配置 git 的用户信息。

• 在你第一次使用 Git 时，需要告诉 Git 你是谁，这样它才能记录每次提交的作者信息。这个操作只需要做一次。
• 打开终端，输入以下两条命令，将 "你的用户名" 和 "你的邮箱" 替换成你自己的信息。

# 配置单个项目 git 的 user.name 和 user.email
git config user.name "你的 github/gitee 用户名"
git config user.email "邮箱地址"

# 全局配置命令则如下：
git config --global user.name "your_username" # 配置用户名
git config --global user.email "your_email" # 配置邮箱

再用 git log 查看是否提交成功：

6. 推送到远程仓库

点击源代码管理面板右上角的三个点（更多操作），选择'Push'。

首次推送可能需要输入远程仓库地址、用户名和密码。

推送成功后，你的代码将同步到远程仓库。

以创建新仓库为例：

(1) 登录你的账号。

(2) 点击页面右上角的 "+" 号，选择 '新建仓库'。

(3) 填写仓库信息：

• 仓库名称：给你的项目起个名字，例如 my-first-project。
• 路径：通常会自动和仓库名称保持一致。
• 简介：可选，简单描述一下你的项目。
• 是否开源：根据你的需求选择公开或私有。
• 初始化仓库：关键一步！不要勾选'使用 Readme 文件初始化这个仓库'。因为我们稍后会从本地上传代码，如果这里初始化了，可能会产生冲突。

(4) 点击'创建'按钮。

创建成功后，跳转到仓库页面。这个页面先别关，我们稍后会用到上面的仓库地址。

(5) 关联远程仓库并推送

• 获取仓库地址：回到你刚才创建的仓库页面，点击右上角的 '克隆/下载' 按钮，选择 HTTPS 协议，然后复制那段 URL（形如 https://gitee.com/你的用户名/你的仓库名.git）。
• 关联远程仓库：回到 VSCode，打开集成终端。输入以下命令，将复制的 URL 粘贴进去：

git remote add origin <你的远程仓库地址> # 本地仓库配置远程仓库地址

提示：origin 表示给本地仓库起了个别名，叫 origin。

• 推送代码：最后，执行推送命令，将本地的 master 分支推送到远程的 origin 仓库。

git push -u origin master # 推送到远程仓库

提示：-u 表示记住往哪个远程仓库推送哪个分支，以后就只用写 git push 即可。

注意：新版本的 Git 默认分支可能是 main，如果你的本地分支是 main，请使用 git push -u origin main。你可以在 VSCode 左下角状态栏看到当前分支名。

第一次推送时，系统会要求验证身份。通常会弹出一个窗口让你输入用户名和密码。输入后，代码就会开始上传。

最后，刷新你的仓库页面，即可看到刚刚上传的所有文件。