VSCODE部署Git上传项目完整流程

一、前言

之前做了一个机器人项目，验收之后，老大让我上传到我们的Git平台去，之前没有搞过，所以这篇教程也是对应的纯小白教程，一早上时间，摸索出来了，对应着整，应该没啥问题。我们用的环境是Windows的环境，如果你是Linux，那你更方便，可以直接整，我就不赘述了。我直接在Windows环境下的vscode里面，终端进行命令行处理。

二、安装部署Git

1.获取Git

首先，我们要获取Git，进行安装，直接去官网下载。官网我就搁这了，有需要自取：

访问 Git 的官方网站：https://git-scm.com/

OK，然后我们点击首页上的 ​​”Download for Windows”​​ 按钮。网站会自动推荐适合你系统的版本（通常是64位），下载它会得到一个 .exe安装文件。也就是如图所示

然后直接进去点下载64位的即可。

2.运行安装程序​

找到刚才下载的安装文件（通常在“下载”文件夹里），​​双击运行​​它。

在安装向导的欢迎界面，直接点击 ​​”Next”​​。

3.阅读并同意许可协议​​

阅读许可协议后，勾选 ​​”I accept the terms in the License Agreement”​​，然后点击 ​​”Next”​​。

4.​​选择安装路径​​

通常使用​​默认路径​​（`C:Program FilesGit`）即可。如果想安装到其他位置，可以点击 “Browse” 修改。确认后点击 ​​”Next”​​。

5.选择组件（重要！）​​

这一步保持​​默认选项​​就行，它们通常包括：

Git Bash（一个用于运行Git命令的终端）

Git GUI（图形化界面工具）

Git LFS(大文件支持)等等，点击 ​​”Next”​​。

6.选择默认编辑器​​

如果你日常使用 ​​VSCode​​，可以在这里选择 ​​”Use Visual Studio Code as Git's default editor”​​。这样以后Git需要编辑信息时会自动打开VSCode，点击 ​​”Next”​​。

7.​​调整 PATH 环境​​

建议选择第二项：​​”Git from the command line and also from 3rd-party software”​​。这能让你在任意地方（如CMD、PowerShell）都能直接使用 git命令。点击 ​​”Next”​​。

8.选择 SSH 可执行文件​​

使用默认的 ​​”Use OpenSSH”​​ 即可。点击 ​​”Next”​​。

9.​​选择 HTTPS 传输后端​​

使用默认的 ​​”Use the OpenSSL library”​​ 即可。点击 ​​”Next”​​。

10.​​配置行结束符转换​​

对于 Windows 系统，推荐选择第一个：​​”Checkout Windows-style, commit Unix-style line endings”​​。这能很好地处理跨平台协作时的行尾符问题。点击 ​​”Next”​​。

11.配置终端模拟器​​

使用默认的 ​​”Use MinTTY (the default terminal emulator on Git for Windows)”​​ 即可。点击 ​​”Next”。

12.​​选择额外选项​​

勾选 ​​”Enable file system caching”​​（文件系统缓存，提升性能）。勾选 ​​”Enable Git Credential Manager”​​（Git凭据管理器，​​非常重要​​，它能帮你安全地记住密码）。点击 ​​”Next”​​。

13.​​安装​​

点击 ​​”Install”​​ 开始安装。完成后点击 ​​”Finish”​​。

14.验证安装​​

按 Win + R键，输入 cmd并回车打开命令提示符。

输入命令 git –version并回车。

如果安装成功，它会显示类似 git version 2.xx.x.windows.1的版本信息。

（图太多了，我就不一个个截了，按着操作就行了，我没提到的，按着默认走就OK）

三、配置GIT

安装好后，需要设置你的用户名和邮箱，这样你每次提交代码时，Git才知道是谁做的。

1.打开 ​​命令提示符 (CMD)​​ 或 ​​Git Bash​​。（Git Bash​​装完之后就会弹出来，你直接输入就行了，CMD用快捷键WIN（就是左边CTRL旁边的那四个小方块按键）+R，纯小白教程了属于是）

2.输入以下两条命令（将引号内的内容替换成​​你自己的名字和邮箱​​）：

git config --global user.name "你的姓名"
git config --global user.email "你的邮箱@example.com"

example是要改的，你是QQ邮箱就改QQ，是163就改163即可。

3.在 VSCode 中安装 GitLens​​，​​打开 VSCode​​。点击左侧活动栏的 ​​扩展图标​​（或使用快捷键 Ctrl+Shift+X），它看起来像一个大方块旁边带一个小方块。也就是这个

在扩展市场的搜索框中，输入 ​​”GitLens”​​。在搜索结果中找到 ​​”GitLens”​​（作者是 ​​GitKraken​​），点击旁边的 ​​”Install”​​ 按钮进行安装。安装完成后，​​建议重启一下 VSCode​​ 以确保插件完全加载。

如果出现下面这样的图 就是装好了，右边的图标，也就是源代码管理，已经检测到了，就会弹出来你的项目数量，然后你的每个文件都会有个U标识记载，代表未跟踪，那就到下一步打包推送了，这步也就结束了。

四、打包到本地存储

git有四个区，工作区  暂存区  本地区  远程仓库。我们目前已经完成了工作区的配置，暂存区已经存好了我们的代码了，那么我们要做的就是先存到本地区。

第一步：提交（Commit）到本地仓库​​

就像寄快递前要把东西先打包好一样，上传前需要先“提交”。

1.在 VSCode 左侧的 ​​“源代码管理”​​ 栏（就是你截图最左边那个），你会看到所有修改过的文件（如 cansend.c, remote.c）。

2.将鼠标悬停在 ​​“更改”​​ 二字上，点击出现的 ​​“+”号图标​​，这叫“暂存”，相当于把文件放进打包箱。

（如果找不到，也可以在每个文件后面点击 +号）

3.在它上方的输入框里，​​必须写一句提交说明​​，比如 “修复CAN发送函数”。这是给你的这次打包贴个标签。

4.点击输入框右边的 ​​对勾图标 ✅​​ 完成提交。

​​第二步：设置远程仓库地址并推送（Push）​​

现在要把打包好的“箱子”寄到正确的地址。

1.按 Ctrl + Shift + P打开命令面板。

2.输入并选择 ​​Git: Add Remote​​（添加远程仓库）。

但是可能会发生如下情况

这个就是Git还没配置你的用户名和邮箱地址。

解决方法：

打开终端（Terminal）​​

在 VSCode 里，按 
Ctrl + `（反引号键，就是ESC下面那个）打开终端。你会看到命令行界面。

git config --global user.name "你的中文或英文名"
git config --global user.email "你的邮箱@example.com"

一行一行输入，然后配置好就行了。

3.输入一个名字，通常就叫 origin，按回车。

4.​​输入最关键的一步：你的远程仓库地址​​。格式通常是：

        http://你的地址/你的用户名/你的项目名.git

​​（这个地址需要问你项目的管理员或去看一眼网页上的仓库地址）​​

记住，不用登录你的github，因为你是用了公司的服务器，和github没有任何关系，直接远程push即可。

5.添加成功后，再次按 Ctrl + Shift + P，输入并选择 ​​Git: Push​​（推送）。

6.此时会弹出一个窗口让你输入用户名和密码！输入之后 就成功了，也就是和以下截图一样的画面。

五、可能遇见的问题

我早上的时候，踩了很多坑，罗列一下可能发生的情况和解决办法，应该对兄弟们有用。

1.问题：错误信息 
fatal: not a git repository (or any of the parent directories): .git

翻译过来就是：​​“致命的错误：这里不是一个 Git 仓库（或者它的任何上级目录也不是）：.git”​​。

这意味着在你的 
ROBOT文件夹里，缺少一个名为 ​​
.git​​ 的隐藏文件夹。

解决办法：

1.在你的文件夹下，打开终端（PowerShell），输入并执行以下命令：

git init

执行成功后，你会看到类似这样的提示：​​


Initialized empty Git repository in C:/Users/XXX/Desktop/XXX/XXX/.git/

2.再次执行提交命令

git remote add origin http:XXXXXXXXXXX/XXX/JH/track_sweep_robot/mcu.git

http往后都是自己的内容，需要修改的，根据实际情况更改，不可照抄。

当然了，也可以直接从本地存储上传到远程仓库。

git add .          # 暂存所有文件
git commit -m "初始提交" # 提交到本地仓库，并写个说明
git push -uf origin main

三行代码，一条条输入，执行这行命令后，终端会​​提示你输入用户名和密码​，正常输入即可。

2.问题：​错误信息 
error: src refspec main does not match any

翻译过来就是：​​“错误：源引用规范‘main’与任何东西都不匹配”​​。这意思是 Git 在你本地找不到一个叫做 
main的分支。本地仓库是空的，还没有进行任何提交（commit），所以不存在一个叫 
main的分支可以让你推送（push）。

解决方法：

注意：我的main分支只是举例，可以自己设置相关的名称分支。

第一步：将代码文件添加到暂存区​​

在终端里执行以下命令，这会把 
ROBOT文件夹下的所有文件都交给 Git 管理：

git add .

第二步：进行第一次提交（Commit）​

git commit -m "初始提交"

执行成功后，会看到类似这样的提示：


[main (root-commit) xxxxxxx] 初始提交


x files changed, x insertions(+)


第三步：再次推送​​
现在本地已经有 main分支了，重新执行推送命令：

git push -uf origin main

基本上就是这些，其他的可能就是网络问题了，可以选择SSH和HTTP连接，反正我这边明确要求必须HTTP连接上传，我就禁用SSH了，具体因为啥我就不知道了……