Git仓库频繁出现空文件‘1’的原因及阻止方法咨询

问题现象 #

Git仓库中莫名生成名为1的空文件，相关命令输出如下：

❯ git status
On branch main
Your branch is ahead of 'origin/main' by 1 commit.
  (use "git push" to publish your local commits)

Untracked files:
  (use "git add <file>..." to include in what will be committed)
    1
❯ cat 1
❯ ls -l 1
-rw-r--r--  1 gerard  wheel  0 Jun 27 12:50 1

推测该文件可能和执行pip install -r requirements.txt有关，需要明确原因并彻底阻止其生成。

可能原因 #

pip本身不会生成这类空文件，大概率是安装过程中的错误重定向操作导致：

• 某个依赖包的安装脚本里存在错误的shell重定向，比如把>&1（标准输出重定向）误写成了> 1，这会把命令输出写入名为1的文件；如果命令没有输出，就会生成空文件。
• 你自己执行pip命令时不小心加了错误的重定向参数，比如pip install -r requirements.txt > 1。

解决方法 #

1. 排查requirements.txt内容
   检查文件里是否包含非包名的内容（比如自定义shell命令），或者是否有拼写错误的包名，这类错误可能触发异常逻辑生成文件。

2. 定位具体触发的包
   执行带详细日志的安装命令，跟踪生成文件的步骤：

   pip install -r requirements.txt -v
   

   观察日志中哪个包的安装过程前后出现了1文件，锁定问题来源。

3. 临时规避（快速解决）
   在仓库的.gitignore文件中添加一行1，让Git自动忽略这个文件，不用每次手动删除：

   echo "1" >> .gitignore
   

4. 彻底修复问题

   • 如果是第三方包的安装脚本有问题，可联系包作者提交修复；
   • 如果是自己维护的包，修改安装脚本中的错误重定向，把> 1改为>&1（如果是要重定向标准输出）或者直接移除错误的重定向语句。

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