获得本地库的方式有两种，一种是本地新建文件夹，一种是在将github内的库clone至本地。后者clone完成后在本地仓库与远程仓库中自动建立关联，操作上基本不会有什么问题，本文讨论的是在本地直接建立一个仓库，并在之后的文章中说明如何与远程仓库建立关联。
我会首先介绍如何建立本地仓库，并在步骤完成后，介绍这些步骤和git版本控制的一些基本逻辑思路。
VScode官方推荐了git-scm的git手册，内容十分细致，从前入深说明了不少概念，且不同操作系统均有覆盖，是很有价值的参考书。不过初次尝试出现的许多问题还是无法直接在书中找到（尽管其实灵活使用书中内容即可解决，但并没有直接提到），需要自己查询。手册点击此处即可
MAC OS中操作github需要打开终端，我们在VScode内打开终端即可。在上边栏选择Terminal—New Terminal即可
1. 配置环境
第一次使用前，先要做一些配置。
1.1 git config
安装完 Git 之后，要做的第一件事就是设置你的用户名和邮件地址。 这一点很重要，因为每一个 Git 提交都会使用这些信息，它们会写入到你的每一次提交中，不可更改：
git config --global user.name ''your name''
git config --global user.email ''your email''
git config --list
使用 ’git config --list‘ 可以查看情况。
1.2 初始化本地仓库
1.2.1 开始操作前首先在终端中需要cd 至想要作为仓库的文件夹
若已存在本地文件夹直接CD 路径
cd 文件夹路径
#例如cd /Users/Steve/Desktop/hello world
若想新建本地文件夹
mkdir 文件夹路径
cd 文件夹路径
PS：不使用mkdir，直接在想要的地方新建文件夹也可。
PS：不同操作系统下获取路径方式不同，OS系统中对文件夹内文件显示简介，简介内显示会有箭头符号，直接复制位置即可，黏贴时会自动转化为文本形式。
1.2.2 使用git init初始化本地仓库
git init
此时本地仓库已经初始化完成，文件夹中会有一个.git隐藏文件实现版本控制。
2.开始使用——追踪文件与提交修改
2.1 将文件加入本地库
此时我们已经建立了版本控制，但无论是之前已经存在的文件还是后续新建文件，git仍然不会追踪，虽然建立在库所在目录中，但并不识别为本地库中文件。我们可以先使用git status查看一下文件状态。
git status
此时会显示出未追踪文件Untracked files（若文件夹为空则没有未追踪文件）
我们需要使用需要使用git add来告诉版本控制它需要追踪哪些文件。作为示范，我首先在VScode内新建了一个add_a_new_file.py文件。然后使用git status：
lvwenyideMacBook-Air-2:hello world lvwenyi$ git status
On branch master
Your branch is up to date with 'origin/master'.
Untracked files:
(use "git add ..." to include in what will be committed)
.DS_Store
add_a_new_file.py
nothing added to commit but untracked files present (use "git add" to track)
可以看到第四行显示了Untracked files，我们新建的文件也在其中。我们使用git add将其添加至暂存区。
lvwenyideMacBook-Air-2:hello world lvwenyi$ git add add_a_new_file.py
lvwenyideMacBook-Air-2:hello world lvwenyi$ git status
On branch master
Your branch is up to date with 'origin/master'.
Changes to be committed:
(use "git restore --staged ..." to unstage)
new file: add_a_new_file.py
Untracked files:
(use "git add ..." to include in what will be committed)
.DS_Store
再次查看状态，可以看到我们新建的文件状态成为了，change to be commited。
此时只需要
git commit -m'关于本次提交想备注的信息'
即可
关于git add与git commit -m’m‘，在当前的VScode中已经不用通过命令行操作，直接在左侧栏第三个源代码控制source control中即可通过按键操作。add对应文件右侧➕号，commit对应上侧√号，单击√（即提交/commit）后会出现信息栏，需要输入信息，即commit -m后引号内内容，提交时必须输入信息，不可以空白。
2.2 文件修改与提交
对于已经加入本地库中的文件，如前文的add_a_new_file.py，我们对其中的内容进行改动后，直接重复git add与git commit -m'message'即可将修改提交至本地库。
2.3 忽略无关文件或移除追踪文件
有时我们建立库的位置会有一些我们不需要加入库的文件，也不希望他们出现在未追踪列表，我们就可以通过建立.gitignore忽略文件。
如果我们不小心add了不想追踪的文件，不想提交的更改，想要取消对文件的追踪，将更改从暂存区移出，就需要使用git rm。关于两个函数的说明在手册中都有，十分清晰。手册说明见此
关于.ignore如果还有更复杂的问题可以参考git停止追踪文件-最佳实践
3. 梳理
在按部就班完成这些操作后，我们应该已经将一个文件添加至追踪列表，并提交至本地库中了。我想梳理一下这些操作的逻辑。
- 首先我们通过git init在我们想要的目录中加入了.git文件，由此有了进行版本控制，追踪文件变动的工具。
- 随后我们通过git add将我们想要追踪的文件加入暂存区，等待提交。
-
最后通过git commit将这个改动确认提交，真正进入本地库。
image.png
以上是手册中的一张图，清晰地解释了不同文件间的关系。Untracked未追踪文件通过git add（add the file)进入staged状态，即暂存区，经commit提交后成为库中的Unmodified文件，Ummodified文件被编辑后即modified文件，通过git add（stage the file）成为staged状态（进入暂存区）等待commit。库中文件（Unmodified）使用rm移出仓库，成为未追踪文件。
关于如何理解git add手册中给出了一段说明：
这是个多功能命令：可以用它开始跟踪新文件，或者把已跟踪的文件放到暂存区，还能用于合并时把有冲突的文件标记为已解决状态等。 将这个命令理解为“精确地将内容添加到下一次提交中”而不是“将一个文件添加到项目中”要更加合适。
关于远程库和本地库关联问题我会另起一篇文章，本地库的建立实际上基本没有问题，主要是根据大多数教程按部就班操作后，虽然可以建立库，但对于自己实际做了什么，以及其在整体中的意义并没有一个清晰的概念，花了不少时间去梳理。实际问题基本都出现在与远程库建立关联、执行push&pull操作中。
文章结束。
昨天终于弄通了本地仓库与远程仓库建立关联并push的流程与机制。这次的尝试中遇见了许多问题，其中最主要的就是upstream问题。在前期尝试过程中只有一两次到达了输入账号密码的步骤，但密码无法输入（据说其实输入进去了，只是不显示），后续直接改用了SSH密钥方式上传。接下来是一些我想到但还没有遇到的问题，准备后续需要再去学习
1.是否可以用本地修改覆盖远程修改？因为当前如果远程修改了，那么似乎会拒绝push，必须优先pull
2.分支管理问题，当前仅仅是默认的master分支，虽然无意间创立了其他的分支，但并没有使用，不过目前在编程过程中也还没有使用分支的功能。
3.git rebase