Python check_output 返回后 split 报 a bytes-like object is required

subprocess.check_output() 已经返回输出，随后执行 .split('=') 却报 TypeError: a bytes-like object is required, not 'str'。在 Python 3 中，这通常是因为返回值仍是 bytes，而传入的分隔符是 str。

先把调用与解析拆开，查看 type(output).__name__，不必打印可能带有令牌或个人路径的完整输出。如果类型是 bytes，需要决定这份输出应当作为文本解码，还是继续按字节处理。重新安装依赖、改动当前工作目录不能解决这个类型边界。

文本输出在入口处解码一次

对明确约定为文本的命令，Python 3.7 及以后可以用 text=True，并根据子进程实际输出编码指定 encoding。下面的完整示例刻意让子进程输出 UTF-8 字节，以便编码前提明确；实际程序应替换命令和参数：

import subprocess
import sys

command = [
    sys.executable,
    "-c",
    "import sys; sys.stdout.buffer.write(b'name=demo\\n')",
]
output = subprocess.check_output(
    command,
    text=True,
    encoding="utf-8",
    errors="strict",
)
key, value = output.rstrip("\r\n").split("=", 1)
print(type(output).__name__, key, value)

预期输出类型为 str，键和值分别为 name、demo。使用参数列表并保持默认 shell=False，无需为这个示例引入命令行解释器。

split("=", 1) 只在第一个等号处分开，允许值中继续包含等号。它仍然要求输出符合一行键值格式：没有等号会导致解包失败，多行输出则应按协议逐行解析。类型修正不代表任意命令输出都变成了合法键值数据。

Python 3.5 不能直接添加 text=True

text 参数从 Python 3.7 加入，encoding 和 errors 参数从 3.6 加入。维护较早的 Python 3.5 代码时，可以先获取字节，再按明确的编码解码：

import subprocess
import sys

command = [
    sys.executable,
    "-c",
    "import sys; sys.stdout.buffer.write(b'name=demo\\n')",
]
raw_output = subprocess.check_output(command)
output = raw_output.decode("utf-8", errors="strict")
key, value = output.rstrip("\r\n").split("=", 1)

较早版本也有 universal_newlines=True，但它会采用文本模式默认编码，并转换换行符。需要特定编码时，先读取字节再显式解码更容易核对。已有代码如果已经返回 str，就不要再调用 .decode()。

Windows 命令的输出不能统一假设为 UTF-8。编码取决于具体程序及其输出设置，Python 的文本模式也不会自动识别任意子进程编码。如果改完后报 UnicodeDecodeError，说明还要核对编码约定；不要用 errors="ignore" 把路径或字段里的字符静默丢弃。

如果在 Windows 上先看到 _readerthread 中的 UnicodeDecodeError，随后捕获结果为 None，应先检查子进程后台解码异常。那时输出尚未正常取得，不能继续按这里的成功返回值调用 split()。

输出本来是二进制时，使用字节分隔符

如果后续逻辑确实处理字节，可以保留 bytes，使用 b"="：

raw_output = b"name=demo\n"
key, value = raw_output.rstrip(b"\r\n").split(b"=", 1)

这里的 key 和 value 都还是 bytes。下游若需要 Unicode 文本，仍应在明确的位置解码。对二进制协议，也只能按协议规定的字节和分隔规则解析，不能因为这个例子用等号就直接套用。

str(raw_output) 不等于解码：不给编码参数时，它会生成类似 "b'name=demo\\n'" 的对象表示，连同 b 前缀和转义内容一起进入字符串。这样的结果可能不再报类型错，却已经改变了数据。

检查正常返回与异常返回

修复后检查返回类型、非 ASCII 内容、带等号的值以及实际换行格式。文本模式会将输出换行转换为 \n；如果下游要求保留原始字节或精确换行，应继续使用二进制模式。

check_output() 在子进程非零退出时会抛出 CalledProcessError。那是命令执行结果的问题，与成功返回后的 .split() 类型错误分开处理，不能用同一个兜底字符串掩盖两类故障。

修改前保留原调用及下游解析逻辑。若下游仍依赖字节类型，回退文本模式改动，并将解码放到真正需要文本的边界；不要在每一层反复编码、解码来碰运气。