Git进阶（十一）：Git 常用操作汇总_git restore --staged

---

一、创建 Git 仓库

打开需要创建仓库的位置，打开Git命令界面或Terminal终端输入git init创建仓库。

创建完成后得到提示Initialized empty Git repository in /Users/huaqiangsun/Git/.git/ 已初始化空的Git仓库在当前目录中，同时可以看到目录中多出来.git文件夹（一般为隐藏文件夹，Mac下可通过shift + cmd + . 组合快捷键查看隐藏文件）。

二、查看仓库文件状态

提起Git，常常会提到工作区、暂存区、版本库概念，这是很通用的说法，其实工作区一般就是指我们能看到的文件、本地操作文件所在的目录，我们正常编写的代码文件、管理的资源文件都是在工作区里操作，这里的文件又细分为受版本控制的文件和不受版本控制的文件。

提到暂存区，就和index文件建立了联系，工作区的新文件和已经修改受版本控制的文件，使用 git add file_name 就可以添加到暂存区，相当于登记报个名，以后提交到版本库的时候会把这些登记的文件都带上，实际上执行了 git add 命令的文件都生成了对应的 object 对象，放在.git/objects目录下，状态变为 staged， 当提交到版本库时，分支会引用这些对象。

版本库就是文件修改的目的地了，最终的修改会提交到版本库，这时提交的文件状态变成 committed，其实也是一种 unmodified 状态，版本库会记录你的每一次提交，可以追溯你每一次修改的内容。

文件状态通常可以分为：

• 不受版本控制的 untracked 状态;
• 受版本控制并且已修改的 modified 状态;
• 受版本控制已修改并提交到暂存区的 staged 状态;
• 从暂存区已经提交到本地仓库的 committed 状态;
• 提交到本地仓库未修改或者从远程仓库克隆下来的 unmodified 状态;

使用git status可以看到当前仓库的文件修改和未提交文件情况。

其中，

• Changes to be committed为暂存区已存在，需要进行提交进仓库的文件；
• Changes not staged for commit为文件被操作尚未提交至暂存区的文件，此类文件需要使用add将其添加至缓存区再提交进仓库；
• Untracked files为未入暂存区文件；

当修改后的文件添加至暂存区后，在提交之前再次进行修改后，非暂存区会再次出现该文件，需再次add添加入暂存区，否则直接commit后仓库中的文件不会包含二次修改的内容。

总结

• git status 只能查看未传送提交的次数，不能查看具体文件信息;
• git cherry -v只能查看未传送提交的描述/说明;
• git log master ^origin/master则可以查看未传送提交的详细信息;

三、向暂存区中添加文件

使用git add [fileName ...]用于将文件添加至暂存区中。

若未提示信息则表示文件添加成功。

添加文件需要填写正确的文件路径，若需要添加多个文件使用空格分隔。

四、提交暂存区文件

使用git commit -m "description"用于将已添加到暂存区的文件进行提交，每次提交可提交多个文件。

五、从仓库中移除文件

当从磁盘删除已提交给仓库中的文件时，由于仓库缓存中还存在该文件，所以使用git rm [fileName]删除缓存中的文件，再提交后该文件就不再纳入版本管理。

若当前操作为误操作，可以通过回滚操作找回文件。

如果要删除之前修改过或已经放到暂存区的文件，则必须使用强制删除选项 -f配参。

若由于误操作将一些非必要文件提交至仓库，可以使用--cached，只删除仓库中的记录并不从磁盘上删除。

git rm 命令后面可以列出文件或者目录的名字，也可以使用 glob 模式。例如：git rm log/\*.log。

注意星号 * 之前的反斜杠 \， 因为 Git 有自己的文件模式扩展匹配方式，所以不用 shell 来帮忙展开。 此命令删除 log/ 目录下扩展名为 .log 的所有文件。

六、设置忽略文件

对于一些日志文件、临时文件以及一些软件生成的配置或输出文件并不需要进行文件管理，所以可以创建一个.gitignore文件将需要忽略的文件名称或表达式写入.gitignore文件，以实现忽略文件的目的。

文件 .gitignore 格式规范如下：

• 所有空行或者以 # 开头的行都会被 Git 忽略。
• 可以使用标准 glob 模式匹配，它会递归地应用在整个工作区中。
• 匹配模式可以以（/）开头防止递归。
• 匹配模式可以以（/）结尾指定目录。
• 要忽略指定模式以外的文件或目录，可以在模式前加上叹号（!）取反。

git同样支持Glob模式，Glob模式为Shell中简化的正则表达式。

• 星号（*）匹配零个或多个任意字符；
• [abc] 匹配任何一个列在方括号中的字符 （这个例子要么匹配一个 a，要么匹配一个 b，要么匹配一个 c）；
• 问号（?）只匹配一个任意字符；
  如果在方括号中使用短划线分隔两个字符， 表示所有在这两个字符范围内的都可以匹配（比如 [0-9] 表示匹配所有 0 到 9 的数字）。
• 使用两个星号（**）表示匹配任意中间目录，比如 a/**/z 可以匹配 a/z 、 a/b/z 或 a/b/c/z 等。

.gitignore 文件生效步骤如下：

• git status --ignored // 查看状态，验证是否已包括忽略的文件

• git rm -r --cached . // 清除缓存，-r表示递归删除

• git status --ignored // 查看具体效果

• git add . // 重新trace file

• git commit -m "update .gitignore" // 提交和注释

七、查看文件修改内容

使用git status只能查看每个文件的修改状态，但是无法看到每个文件的内容有哪些被修改，所以可以使用git diff查看所有追踪文件的修改对比。

需要注意的是，git diff是查看未暂存的文件中被修改的内容，当将该文件添加入暂存区后，就无法再通过git diff查看修改内容，需要使用git diff --cached。

八、移动文件

当需要重命名文件时，可以使用git mv [oldFileName] [new FileName]。Git对于重命名操作会分为三步进行，第一步首先重命名文件，然后再从仓库中删除原有的文件，最后将新文件添加进暂存区等待提交。

$ mv README.md LOOKME.md
$ git rm README.md
$ git add LOOKME.md
1
2
3

若通过软件进行批量修改文件时，也要按照该流程先删除原文件再添加新文件。

九、撤销操作

当由于一些操作失误提交或修改了文件内容时，可以通过Git回滚操作，回滚到修改之前的状态。

回忆下前面提到的文件状态，文件状态通常可以分为：

• 不受版本控制的 untracked 状态;
• 受版本控制并且已修改的 modified 状态;
• 受版本控制已修改并提交到暂存区的 staged 状态;
• 从暂存区已经提交到本地仓库的 committed 状态;
• 提交到本地仓库未修改或者从远程仓库克隆下来的 unmodified 状态;
  

9.1 撤销暂存区文件

使用git restore --staged [fileName]或git reset HEAD [fileName]可以将暂存区文件恢复。

说明：git restore命令是 Git 2.23 版本之后新加的，用来分担 git checkout 命令的功能，通过用暂存区或者版本库中的文件覆盖本地文件的修改，以达到回退修改的目的，同时也可以使用版本库中的文件覆盖暂存区的文件，达到回退git add命令的目的。

!!注意，这个操作不会影响分支记录，就是相当于之前的 git checkout 命令重新检出一份文件来覆盖本地的修改。

git reset 其实就是用来设置分支的头部指向，当进行了一系列的提交之后，忽然发现最近的几次提交有问题，想从提交记录中删除，这是就会用到 git reset 命令，这个命令后面跟 commit id，表示当前分支回退到某个 commit id 对应的状态，之后的日志记录被删除，工作区中的文件状态根据参数的不同会恢复到不同的状态。

• --soft: 被回退的那些版本的修改会被放在暂存区，可以再次提交。

• --mixed: 默认选项，被回退的那些版本的修改会放在工作目录，可以先加到暂存区，然后再提交。

• --hard: 被回退的那些版本的修改会直接舍弃，就像它们没有来过一样。

使用 git rest HEAD file_name 命令就可以将一个文件回退到 HEAD 指向版本所对应的状态，其实就是当前版本库中的状态，也就相当于还原了本地的修改。

对于工作区中未加到暂存区和版本库的文件，执行了 git add 操作之后可通过如下方法还原：

• git rm --cached newfile
• git restore --staged newfile
• git reset HEAD newfile

注：使用后两个命令的时候不能是版本库的第一个文件。

9.2 撤销对文件的修改

使用git checkout -- [fileName]可以将该文件回滚到上一次提交的状态。

!注：记得git checkout -- <file>是一个危险的命令。 你对那个文件在本地的任何修改都会消失。Git 会用最近提交的版本覆盖掉它。 除非你确实清楚不想要对那个文件的本地修改了，否则请不要使用这个命令。

声明：由于没有添加到暂存区的文件无法被追踪，所以它的任何修改是没有办法回退！只能通过本地文件撤销操作进行。

十、查看操作历史

如果想要查看某个项目中所有提交信息，可以使用git log打印所有参与者的提交记录。

每条记录都会显示提交的SHA-1 校验，作者名字和作者邮箱以及提交时间并按提交时间倒序排列。

除了简单的git log外，还可以添加参数用于筛选和格式化输出信息：

• -p --patch：它会显示每次提交所引入的差异。 也可以限制显示的日志条目数量，例如使用 -2 选项来只显示最近的两次提交。
  

• --stat：在每次提交的下面列出所有被修改过的文件、有多少文件被修改了以及被修改过的文件的哪些行被移除或是添加了。 在每次提交的最后还有一个总结。
  

• --pretty：这个选项有一些内建的子选项供你使用。 比如 oneline 会将每个提交放在一行显示，在浏览大量的提交时非常有用。 另外还有 short，full 和 fuller 选项，它们展示信息的格式基本一致，但是详尽程度不一；
  
  使用formart可以自定义打印的格式，常用格式信息如下：
  

示例 10.1 将日志信息显示在一行上

$ git log --pretty=oneline
1

示例 10.2 以 short 格式输出仓库修改信息

$ git log --pretty=short
1

示例 10.3 以 full 格式输出仓库修改信息

$ git log --pretty=full
1

示例 10.4 以 fuller 格式输出仓库修改信息

$ git log --pretty=fuller
1

修改文件人员与提交文件人员可以不是同一个人，所以在查询日志时会区分修改人与提交人。

十一、Git 修改分支名称

使用git命令进行如下操作：

1. 修改本地分支名称

git branch -m oldBranchName newBranchName
1

2. 将本地分支的远程分支删除

git push origin :oldBranchName
1

3. 将改名后的本地分支推送到远程，并将本地分支与之关联

git push --set-upstream origin newBranchName
1

十二、提交本地项目至远程仓库

在本地创建的文件夹项目，可以通过以下步骤将其提交到远程 Git 仓库中：

1. 在远程 Git 仓库中创建一个新的空仓库。例如，可以在 GitHub 上创建一个新的仓库。

2. 在本地项目根目录中使用以下命令初始化 Git 仓库：

   git init
1

3. 使用以下命令将本地项目与远程 Git 仓库关联起来，其中 remote-url 是远程 Git 仓库的地址：

   git remote add origin remote-url
1

4. 使用以下命令将本地项目的代码添加到 Git 仓库中：

   git add .
1

这将添加所有更改的文件到 Git 仓库中，也可以使用 git add file-name 命令来添加指定的文件。

5. 使用以下命令提交代码到本地 Git 仓库中，其中 commit-message 是本次提交的消息：

   git commit -m "commit-message"
1

6. git pull获取远程库与本地同步合并(如果远程库不为空必须做这一步，否则后面的提交会失败)

git pull –rebase origin master
1

7. 使用以下命令将本地 Git 仓库中的代码推送到远程 Git 仓库中：

   git push -u origin master
1

这将会将本地 Git 仓库中的 master 分支代码推送到远程 Git 仓库中。

需要注意的是，在执行以上命令时，需要确保本地和远程 Git 仓库中的代码分支和提交记录保持一致，避免出现代码冲突等问题。同时，建议在提交代码前先备份重要的代码文件，以防止不必要的代码丢失。

十三、拓展阅读

• 《Git进阶（一）：git管理文件之后文件颜色的含义》
• 《Git进阶（二）：git revert 用法》
• 《Git进阶（三）：webstorm的git切换分支》
• 《Git进阶（四）：Git命令图解》
• 《Git进阶（五）：git分支管理策略》
• 《Git进阶（六）：git 刷新分支、修改本地和远程分支名称》
• 《Git进阶（七）： 打标签》
• 《Git进阶（八）：git stash和git add》
• 《Git进阶（九）：Git命令实现提交指定文件》
• 《Git进阶（十）：Git命令实现修改指定文件名称》