这是我参与「第五届青训营 」伴学笔记创作活动的第 7 天

Git

配置

git config --global user.name "xxxx"
git config --global user.email "xxx@xxx.xxx"

使用git

• 查看当前仓库的状态

  git status
  

• 初始化仓库

  git init
  

• 文件状态：

  1. 未跟踪
  2. 已跟踪
  3. 暂存
  4. 未修改
  5. 已修改

• 未跟踪 → 暂存

  git add <filename> 将文件切换到暂存的状态
  git add * 将所有已修改（未跟踪）的文件暂存
  

• 暂存 → 未修改

  git commit -m "xxxx" 将暂存的文件存储到仓库中
  git commit -a -m "xxxx" 提交所有已修改的文件（未跟踪的文件不会提交）
  

• 未修改 → 修改

  修改代码后，文件会变为修改状态。

• git 指令大全

本地常用的命令

1. 重置文件

   git restore <filename> # 恢复文件
   git restore --staged <filename> # 取消暂存状态
   

2. 删除文件

   git rm <filename> # 删除文件
   git rm <filename> -f # 强制删除
   

3. 移动文件

   git mv from to # 移动文件 重命名文件
   

分支

1. git在存储文件时，每一次代码代码的提交都会创建一个与之对应的节点，git就是通过一个一个的节点来记录代码的状态的。

2. 节点会构成一个树状结构，树状结构就意味着这个树会存在分支，默认情况下仓库只有一个分支，命名为master。

3. 在使用git时，可以创建多个分支，分支与分支之间相互独立，在一个分支上修改代码不会影响其他的分支。

4. 分支相关语法

   git branch # 查看当前分支
   git branch <branch name> # 创建新的分支
   git branch -d <branch name> # 删除分支
   git switch <branch name> # 切换分支
   git switch -c <branch name> # 创建并切换分支
   git merge <branch name> # 合并分支
   

5. 在开发中，都是在自己的分支上编写代码，代码编写完成后，在将自己的分支合并到主分支中。

变基（rebase）

在开发中除了通过 merge 来合并分支外，还可以通过变基来完成分支的合并。

通过 merge 合并分支时，在提交记录中会将所有的分支创建和分支合并的过程全部都显示出来，这样当项目比较复杂，开发过程比较波折时，我必须要反复的创建、合并、删除分支。这样一来将会使得我们代码的提交记录变得极为混乱。

• 变基的原理：

  1. 当我们发起变基时，git 会首先找到两条分支的最近的共同祖先
  2. 对比当前分支相对于祖先的历史提交，并且将它们提取出来存储到一个临时文件中
  3. 将当前部分指向目标的基底
  4. 以当前基底开始，重新执行历史操作

• 语法

  git checkout dev
  git rebase login
  # 将分支dev变基到分支login
  

变基和 merge 对于合并分支来说最终的结果是一样的！但是变基会使得代码的提交记录更整洁更清晰！注意！大部分情况下合并和变基是可以互换的，但是如果分支已经提交给了远程仓库，那么这时尽量不要变基。

远程仓库（remote）

远程的git仓库和本地的没有本质区别，不同点在于远程的仓库可以被多人同时访问使用，便于协同开发。在实际工作中，git的服务器通常由公司搭建内部使用或是购买一些公共的私有git服务器。目前常用的库有两个：GitHub和Gitee（码云）

• 远程库的操作的命令

  git clone <url> # 从远程库下载代码
  
  git remote # 列出当前的关联的远程库
  git remote add <远程库名> <url> # 关联远程仓库
  git remote remove <远程库名>  # 删除远程库
  
  git push -u <远程库名> <分支名> # 向远程库推送代码，并和当前分支关联
  git push <远程库> <本地分支>:<远程分支> # 从将本地的分支版本上传到远程并合并
  
  git fetch <远程库名> <分支名> # 要想推送成功，必须先确保本地库和远程库的版本一致，fetch它会从远程仓库下载所有代码，但是它不会将代码和当前分支自动合并。因此，使用fetch拉取代码后，必须要手动对代码进行合并	
  git pull <远程库名> <分支名> # 从服务器上拉取代码并自动合并 
  

  注意：推送代码之前，一定要先从远程库中拉取最新的代码

tag 标签

• 当头指针没有执行某个分支的头部时，这种状态我们称为分离头指针（HEAD detached），分离头指针的状态下也可以操作操作代码，但是这些操作不会出现在任何的分支上，所以注意不要在分离头指针的状态下来操作仓库。

• 如果非得要回到后边的节点对代码进行操作，则可以选择创建分支后再操作

  git switch -c <分支名> <提交id>
  

• 可以为提交记录设置标签，设置标签以后，可以通过标签快速的识别出不同的开发节点

  git tag
  git tag 版本
  git tag 版本 提交id
  git push 远程仓库 标签名
  git push 远程仓库 --tags
  git tag -d 标签名 # 删除标签
  git push 远程仓库 --delete 标签名 # 删除远程标签
  

gitignore

• 默认情况下，git会监视项目中所有内容。

• 可以在项目目录中添加一个.gitignore文件，来设置那些需要git忽略的文件（如node_modules目录中的内容）

github的静态页面

• 在 github 中，可以将自己的静态页面之间部署到 github 中，它会给我们提供一个地址使得我们的页面变成一个真正的网站，可以供用户访问。
• 要求：
  • 静态页面的分支必须叫做：gh-pages
  • 如果希望页面可以通过 xxx.github.io 访问，则需要将库的名字配置为 xxx.github.io

docusaurus

• facebook推出的开源的静态的内容管理系统，通过它可以快速的部署一个静态网站

• 使用

  1. 网址：docusaurus.io/

  2. 安装：npx create-docusaurus@latest my-website classic

  3. 启动项目：npm start 或 yarn start

  4. 构建项目：npm run build 或 yarn build

• 配置项目

  • docusaurus.config.js 项目的配置文件

• 添加页面

  • 在docusaurus框架中，页面分成三种：page、blog、doc