VS Code 使用 Git 上传代码至 GitHub 完整指南

准备工作

在开始之前，请确保你已拥有一个 GitHub 账户，并在电脑上安装了 Git 和 VS Code。Git 的安装方法可参考相关教程，VS Code 直接安装即可。

在 GitHub 上创建仓库

登录 GitHub 后，点击右上角的“+”号，选择“New repository”。输入项目名称，其他选项保持默认，点击“Create repository”即可创建新仓库。

创建成功后，可以点击页面中的蓝色链接生成 README.md 文件，或在新建仓库时直接勾选“Add a README file”选项。

Git 首次安装设置

打开 Git Bash，输入以下命令查看当前配置：

git config --list

然后配置全局用户名和邮箱：

git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"

建议用户名和邮箱与 GitHub 账户保持一致。

方法一：通过 HTTPS 克隆仓库

1. 克隆远程仓库

在 VS Code 中按 Ctrl+Shift+P，输入“git”并选择“克隆”。粘贴 GitHub 仓库的 HTTPS 地址，选择本地存放位置（路径不要包含中文），确认后开始克隆。

2. 修改代码并提交

打开克隆下来的项目，修改 README.md 文件并保存。左侧会出现蓝色数字图标，点击进入 Git 管理界面。

在“更改”列表中，文件后的 M 表示已修改。点击文件可查看具体改动，点击“+”号暂存更改，填写提交备注后点击右上角的对勾提交到本地仓库。

3. 推送到远程仓库

点击界面上方的推送按钮，如有登录提示按提示操作。推送完成后，在 GitHub 仓库页面即可看到更新。

方法二：使用 VS Code 终端提交

1. 初始化本地仓库

新建一个空文件夹，在 VS Code 中打开终端，执行：

git init

此时文件夹内会出现 .git 目录。

2. 提交文件到本地仓库

添加测试文件后，提交单个文件：

git add readme.txt
git commit -m "第一次提交readme"

或提交全部文件：

git add .
git commit -m "全部提交"

3. 推送到远程仓库

关联远程仓库并推送：

git remote add origin https://github.com/LL-Elsie/git_test.git
git remote set-url origin https://github.com/LL-Elsie/git_test.git
git branch -M test1
git push -u origin test1

这样会在远程仓库创建 test1 分支，并将本地文件推送上去。

常用 Git 指令

git branch                  # 查看当前分支
git checkout -b main       # 新建并切换到 main 分支
git branch -M main         # 新建 main 分支
git checkout main          # 切换到 main 分支

处理远程仓库已存在的情况

如果远程仓库已有内容，推送时可能报错 error: remote origin already exists.。此时先查看远程库信息：

git remote -v

然后删除旧远程仓库并重新关联：

git remote rm origin
git remote add origin https://github.com/LL-Elsie/Practice.git
git push origin master

解决推送大小限制问题

若推送时提示 the remote end hung up unexpectedly，说明推送内容超出 Git 默认大小限制。找到本地仓库 .git 文件夹中的 config 文件，添加或修改以下内容：

[http]
postBuffer = 1024288000

保存后重新推送即可。