---

1. 命令简介

git status 命令是 Git 中最常用的命令之一，用于查看当前工作目录和暂存区（staging area）的状态。它可以帮助开发者了解哪些文件已被修改、哪些文件被暂存、哪些文件未被跟踪等。

主要用途

• 检查当前 Git 仓库的状态。
• 识别未提交的更改。
• 了解哪些文件已被暂存。
• 查看哪些文件被 Git 忽略。

2. 命令的基本语法和用法

基本语法

git status [<options>]

常见的使用场景

1. 查看当前仓库状态

git status

输出示例：

On branch main
Your branch is up to date with 'origin/main'.

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
        modified:   file1.txt

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        newfile.txt

no changes added to commit (use "git add" and/or "git commit -a")

解释

• On branch main：当前分支是 main。
• Changes not staged for commit：列出了已修改但未暂存的文件。
• Untracked files：列出了未被 Git 追踪的新文件。
• no changes added to commit：提示需要使用 git add 或 git commit -a 进行提交。

3. 命令的常用选项及参数

选项	作用
-s 或 --short	使用简洁模式显示状态信息
-b 或 --branch	显示当前分支信息
--ignored	显示被忽略的文件
--untracked-files=<mode>	控制未跟踪文件的显示方式

选项示例

1. 使用 -s 简洁模式

git status -s

输出示例：

 M file1.txt
?? newfile.txt

解释

• M file1.txt：file1.txt 已被修改但未暂存。
• ?? newfile.txt：newfile.txt 是一个未被跟踪的新文件。

2. 仅显示当前分支信息

git status -b

输出示例：

## main...origin/main

表示当前分支是 main，并且与远程 origin/main 处于相同状态。

4. 命令的执行示例

1. 检查修改后的文件

echo "Hello" > file1.txt
git status

输出示例：

On branch main
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
        modified:   file1.txt

2. 添加文件后检查状态

git add file1.txt
git status

输出示例：

On branch main
Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
        modified:   file1.txt

3. 提交文件后检查状态

git commit -m "Updated file1.txt"
git status

输出示例：

On branch main
nothing to commit, working tree clean

5. 命令的进阶用法

1. 结合 --ignored 查看被忽略的文件

git status --ignored

如果 .gitignore 文件中包含 logs/ 目录，则输出可能如下：

Ignored files:
  logs/

2. 只显示未跟踪的文件

git status --untracked-files=all

该命令会列出所有未跟踪的文件。

6. 命令的常见问题与解答

1. 为什么 git status 显示文件被修改，但 git diff 没有输出？

可能原因：

• 文件的权限或换行符发生了变化。
• 使用 git diff --stat 可以更详细查看修改内容。

2. 为什么 git status 显示 nothing to commit, working tree clean 但我明明有更改？

可能原因：

• 你可能在错误的分支上。
• 你的更改可能没有被 Git 追踪。
• 运行 git status --ignored 以检查被忽略的文件。

7. 总结与建议

总结

• git status 是 Git 中最常用的命令之一，用于查看工作区和暂存区的状态。
• 结合 -s、--ignored、--untracked-files 等选项，可以更高效地查看不同状态的信息。

最佳实践

• 在提交代码前，务必使用 git status 确保所有更改都在跟踪范围内。
• 使用 git status -s 获取更精简的输出，提高可读性。
• 如果发现 git status 结果与预期不符，可结合 git diff 进一步分析。

通过熟练掌握 git status，可以更好地管理代码变更，提高工作效率！