ellmos-ai 中文 —
nulcleaner官方中文版本。
nulcleaner - Windows NUL File Cleanup (中文)
问题描述
在 Windows 的 Git Bash 中使用 /dev/null 时（例如 > /dev/null），输出不会重定向至空无之处，反而会在当前目录中生成一个名为 nul 的实际文件。Windows 将“NUL”保留为设备名称，这意味着无法通过常规方式删除这些文件。
该工具通过扩展 UNC 路径（\\?\）查找并删除此类 NUL 文件。
模式
| 模式 | 描述 |
|---|---|
scan |
递归扫描目录中的 NUL 文件 |
delete |
查找并删除 NUL 文件 |
gui |
带文件选择功能的图形界面 |
CLI 用法
# 仅扫描（显示找到的 NUL 文件） (中文)
python nulcleaner.py scan /path/to/directory
# 扫描并删除 (中文)
python nulcleaner.py delete /path/to/directory
# 启动 GUI 模式 (中文)
python nulcleaner.py gui
无界面 API (用于集成)
该工具还提供了用于无界面操作的 Python API：
from nulcleaner import clean_nul_files_headless
result = clean_nul_files_headless("/path/to/directory", verbose=True)
print(f"Found: {result['found']}, Deleted: {result['deleted']}")
返回值： {'found': int, 'deleted': int, 'errors': list}
技术细节
- 使用扩展 UNC 路径（
\\?\）删除 Windows 保留的文件名 - 使用
os.walk()进行递归扫描 - 基于 tkinter 的 GUI（无外部依赖）
- 仅在 Windows 系统上有效（即出现该问题的地方）
预防措施
最好完全避免在 Git Bash 中使用 /dev/null。替代方案：
- 直接忽略输出
- 使用
2>&1进行 stderr 重定向 - 在 Shell 脚本中注意 Windows 兼容性