使用git add -N/--intent-to-add后暂存区无变化的问题求助

我最近了解到git add --intent-to-add（简写为git add -N）参数，原本理解它能把文件标记为待添加状态，但不暂存文件内容（等效于添加空白文件）。不过执行git add -N Beanstalk.md后，git status显示的状态完全没变化，具体操作流程如下：

u@user MINGW64 ~/AWS (main)
$ ls
Beanstalk.md  billing_and_dashboard.md  Certificates.md  IAM_Identity_center.md

u@user MINGW64 ~/AWS (main)
$ git status
On branch main
Your branch is up to date with 'origin/main'.

Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
        deleted:    aws_notes.md

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)
        new file:   Beanstalk.md
        new file:   Certificates.md
        new file:   IAM_Identity_center.md
        new file:   billing_and_dashboard.md


u@user MINGW64 ~/AWS (main)
$ git add -N Beanstalk.md 

u@user MINGW64 ~/AWS (main)
$ git status
On branch main
Your branch is up to date with 'origin/main'.

Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
        deleted:    aws_notes.md

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)
        new file:   Beanstalk.md
        new file:   Certificates.md
        new file:   IAM_Identity_center.md
        new file:   billing_and_dashboard.md

问题解析 #

git add -N的核心作用是让Git追踪这个新文件的存在，但它不会改变git status里的显示分类——文件依然会留在「Changes not staged for commit」下，这就是你看不到状态变化的原因。

它的实际生效表现体现在两个地方：

1. 差异对比：执行git add -N后，直接运行git diff Beanstalk.md会输出文件的全部内容（对比空文件的差异）；如果没执行-N，git diff不会显示这个新文件的内容。
2. 暂存区细节：用git ls-files --stage查看，会看到该文件的条目，模式为100644但对应空白内容的SHA值（如0000000000000000000000000000000000000000），这就证明它已经被标记为待添加状态。

简单说，git add -N是给Git打个招呼“我以后要提交这个文件”，但现在不把内容放暂存区，方便后续做差异对比和追踪，不会直接在git status的分类上体现变化。

内容的提问来源于stack exchange，提问作者pyknight202