【Bug】Windows｜Git Bash｜grep 报错 Binary file (standard input) matches

（人话版）Git Bash 中 grep 管道中文乱码问题的解决

在 Windows 的 Git Bash 中使用grep管道过滤 Python 程序输出时，遇到了Binary file (standard input) matches报错，且grep -a强制输出后中文全部乱码。根本原因是程序输出了 ANSI 颜色转义码导致grep误判为二进制，同时 Windows 默认的 GBK 编码与 Python 输出的 UTF-8 不匹配导致中文乱码。在~/.bashrc中添加export PYTHONIOENCODING=utf-8即可永久解决乱码问题；临时使用的话，grep -a可以绕过二进制检测。

问题描述

在 Windows 的 Git Bash 中，将程序输出通过管道传给grep时遇到两个问题：

1. grep无输出：程序输出包含 ANSI 颜色转义码，grep将其识别为二进制文件，直接报Binary file (standard input) matches。
2. 中文乱码：加了grep -a能看到内容，但中文显示为乱码（如ȱ□□、û□□□ҵ□）。

示例：

$ my-python-tool--verbose|grepERROR Binaryfile(standard input)matches $ my-python-tool--verbose|grep-aERROR[ERROR]模□□□初始化失败□□[ERROR]□□□□找不到配置文件

原因分析

两个问题各有独立原因：

问题一：Binary file matches

程序输出中包含 ANSI 颜色转义序列（如\x1b[33m表示黄色文字），grep在检测输入时发现非文本字节，将整个输入当作二进制文件处理，因此不会正常输出匹配行。

问题二：中文乱码

Windows 系统默认编码是 GBK（CP936），而现代程序（如 Python）默认输出 UTF-8 编码。Git Bash 的管道在 Windows 上使用系统默认编码传递数据，UTF-8 的中文在 GBK 终端中被错误解码，产生乱码。

两者叠加就出现了 “能看到英文但中文全是方块” 的现象。

解决方案

方案一：设置环境变量（推荐，永久生效）

在~/.bashrc中添加：

exportPYTHONIOENCODING=utf-8

对于 PowerShell 用户，在$PROFILE中添加：

$env:PYTHONIOENCODING ="utf-8"

这样 Python 程序的输出编码与终端一致，中文就能正常显示。

方案二：grep 加-a参数（临时解决二进制识别问题）

my-python-tool--verbose|grep-aERROR

-a让grep将输入强制当作文本处理，解决 “Binary file matches” 的问题，但不解决乱码。

方案三：关闭程序的颜色输出

# 方式一：程序自带选项my-python-tool--verbose--no-color|grepERROR# 方式二：通过环境变量（部分程序支持）NO_COLOR=1my-python-tool--verbose|grepERROR

关闭颜色输出后，grep不会误判二进制，但需要程序本身支持。

方案四：重定向到文件再查看

my-python-tool--verbose>output.txt2>&1grepERROR output.txt

写文件时不会经过管道编码转换，VSCode 等编辑器会自动识别 UTF-8。

最佳实践

同时设置PYTHONIOENCODING和使用grep -a，一劳永逸：

# ~/.bashrcexportPYTHONIOENCODING=utf-8# 使用时my-python-tool--verbose|grep-aERROR

（扩展版）Windows Git Bash 使用 grep 管道过滤 Python 输出乱码解决方案：Binary file matches、UTF-8 中文乱码、ANSI 颜色码问题详解

前言

在 Windows 环境下使用 Git Bash 进行开发时，经常会遇到一个比较隐蔽的问题：

程序直接运行时中文显示正常，但是一旦通过管道传递给grep、awk、sed等 Linux 命令进行过滤，输出突然出现：

• Binary file (standard input) matches
• 中文乱码；
• 中文变成□□□；
• UTF-8 字符显示异常；
• 英文正常但中文损坏。

例如：

python main.py--verbose|grepERROR

结果：

Binary file (standard input) matches

于是尝试：

python main.py--verbose|grep-aERROR

虽然可以看到匹配内容：

[ERROR] 初始化失败

但是中文变成：

[ERROR] 初始化失败

或者：

[ERROR] □□□□

这个问题看似是 grep 的问题，实际上涉及：

• Windows 默认编码；
• Python 标准输出编码；
• Git Bash 的终端环境；
• ANSI 彩色控制字符；
• Unix 管道机制。

本文记录完整排查过程以及推荐解决方案。

一、问题现象

1. grep 提示 Binary file matches

示例：

python test.py|grepERROR

输出：

Binary file (standard input) matches

正常情况下：

grep 应该显示：

[ERROR] 配置文件不存在 [ERROR] 数据初始化失败

但是它认为输入不是普通文本。

2. 使用 grep -a 后中文乱码

执行：

python test.py|grep-aERROR

输出：

[ERROR] æ•°æ®åŠ è½½å¤±è´¥

或者：

[ERROR] □□□

说明：

• grep 已经可以读取内容；
• 但是字符编码错误。

二、问题产生的原因分析

这个问题实际上由两个独立问题叠加产生。

1. grep 为什么认为输入是二进制？

ANSI 颜色控制符导致误判

很多现代 CLI 程序为了提高可读性，会给输出添加颜色。

例如：

红色 ERROR：

\x1b[31mERROR\x1b[0m

其中：

\x1b

代表 ESC 控制字符。

终端看到：

ERROR

但是实际输出：

ESC + [31m + ERROR + ESC + [0m

对于终端：

这些字符表示颜色。

但是对于 grep：

它看到：

非普通文本控制字符

可能判断：

这不是文本文件，而是二进制数据。

于是输出：

Binary file matches

2. 为什么 grep -a 可以解决？

grep 参数：

-a

含义：

--text

强制 grep：

把输入当作文本处理。

例如：

python main.py|grep-aERROR

即可绕过二进制检测。

但是：

注意：

grep -a只能解决：

Binary file matches

不能解决：

中文乱码

因为编码问题完全不同。

三、Windows 中文乱码的根本原因

Windows 历史编码问题

Windows 长期使用：

GBK

也叫：

CP936

作为中文系统默认编码。

但是现在的软件：

例如：

• Python 3；
• Node.js；
• Go；
• Rust；

默认大量采用：

UTF-8

例如：

中文：

错误

UTF-8：

E9 94 99 E8 AF AF

GBK：

B4 ED CE F3

两种编码完全不同。

如果：

程序输出 UTF-8：

E9 94 99

终端按照 GBK 解析：

乱码

四、Python 输出编码问题

Python 在 Windows 下有多个编码来源：

1. Python 默认 stdout 编码

查看：

importsysprint(sys.stdout.encoding)

可能输出：

cp936

或者：

utf-8

2. 环境变量影响

Python 支持：

PYTHONIOENCODING

用于指定：

• stdin；
• stdout；
• stderr；

编码。

例如：

exportPYTHONIOENCODING=utf-8

之后：

Python 输出统一使用 UTF-8。

五、推荐解决方案

方案一：设置 PYTHONIOENCODING（推荐）

这是最彻底的方法。

编辑：

~/.bashrc

添加：

exportPYTHONIOENCODING=utf-8

保存。

重新打开 Git Bash。

检查：

echo$PYTHONIOENCODING

输出：

utf-8

即可。

优点：

• 永久生效；
• 所有 Python 程序生效；
• 不需要每次输入参数。

六、grep -a 临时解决 Binary file matches

如果只是临时查看：

使用：

grep-aERROR

例如：

python main.py--verbose|grep-aERROR

适合：

• 临时排查日志；
• 快速过滤输出。

但是：

它不是根治方案。

因为：

ANSI 颜色码仍然存在。

七、关闭 ANSI 彩色输出

很多 CLI 工具支持：

方法一：程序参数关闭

例如：

python main.py --no-color

或者：

tool--color=false

方法二：使用 NO_COLOR 标准

很多现代 CLI 支持：

NO_COLOR=1command

例如：

NO_COLOR=1python main.py|grepERROR

关闭颜色后：

输出：

ERROR 初始化失败

而不是：

ESC[31mERRORESC[0m

grep 也不会误判。

八、重定向到文件再分析

另一种稳定方式：

python main.py>output.txt2>&1

然后：

grepERROR output.txt

优点：

• 文件编码稳定；
• VSCode 可以识别 UTF-8；
• 方便保存日志。

适合：

大型日志分析。

例如：

python train.py>train.log2>&1grep-nERROR train.log

九、PowerShell 下如何设置

如果不是 Git Bash，而是 PowerShell：

打开：

$PROFILE

添加：

$env:PYTHONIOENCODING="utf-8"

重新打开 PowerShell。

也可以临时：

$env:PYTHONIOENCODING="utf-8"python main.py

十、Git Bash 推荐配置

对于 Windows 开发环境：

建议：

~/.bashrc

添加：

# Python 输出统一使用 UTF-8exportPYTHONIOENCODING=utf-8# 禁止部分工具输出颜色exportNO_COLOR=1

之后：

python xxx.py|grepERROR

基本不会再出现：

• 中文乱码；
• Binary file matches。

十一、如何判断到底是哪一个问题？

可以按照下面顺序排查。

第一步：直接运行程序

python test.py

如果：

中文正常：

说明程序没问题。

第二步：查看编码

执行：

python-c"import sys;print(sys.stdout.encoding)"

如果：

cp936

说明 Python 仍然使用 GBK。

第三步：检查 ANSI

查看原始输出：

python test.py|xxd

如果看到：

1b 5b 33 31

说明存在：

ESC [31m

即颜色控制符。

第四步：测试 grep -a

python test.py|grep-aERROR

如果：

能显示内容：

说明只是二进制检测问题。

十二、为什么 Linux 和 macOS 很少遇到？

因为：

Linux/macOS 默认：

UTF-8

整个系统：

• 文件编码；
• 终端编码；
• Shell 环境；

基本统一。

Windows 历史原因：

同时存在：

• GBK；
• UTF-8；
• UTF-16；
• OEM 编码。

所以跨平台开发时更容易遇到。

十三、开发者最佳实践

如果你的程序需要被别人通过管道调用：

建议：

1. 默认不要输出颜色

检测：

sys.stdout.isatty()

例如：

ifsys.stdout.isatty():enable_color()else:disable_color()

原因：

终端需要颜色。

但是：

管道不需要。

2. 明确指定 UTF-8

Python：

print(text.encode("utf-8"))

或者：

启动时：

PYTHONIOENCODING=utf-8 python app.py

3. 提供 --no-color 参数

这是优秀 CLI 工具的标准设计。

例如：

tool --verbose --no-color

总结

Windows Git Bash 中使用 grep 过滤 Python 输出时出现：

Binary file (standard input) matches

以及：

中文乱码

通常不是 grep 本身的问题，而是两个因素共同导致：

1. ANSI 颜色控制符导致 grep 判断输入为二进制
2. Windows GBK 与 Python UTF-8 输出编码不一致

推荐解决方案：

永久配置：

exportPYTHONIOENCODING=utf-8

临时过滤：

grep-a

关闭颜色：

NO_COLOR=1

最佳实践：

# ~/.bashrcexportPYTHONIOENCODING=utf-8exportNO_COLOR=1

配置完成后，Git Bash 中 Python、grep、管道组合即可稳定处理中文日志输出。

本文记录 Windows 开发环境中的实际排错过程，适用于 Git Bash、Python CLI 工具以及大多数基于 UTF-8 输出的现代开发工具。

本账号所有文章均为原创，欢迎转载，请注明文章出处：https://shandianchengzi.blog.csdn.net/article/details/162127355。百度和各类采集站皆不可信，搜索请谨慎鉴别。技术类文章一般都有时效性，本人习惯不定期对自己的博文进行修正和更新，因此请访问出处以查看本文的最新版本。