终端可执行的Black格式化命令在subprocess中失效的问题求助

看起来你遇到了subprocess调用shell管道命令的典型问题，还可能夹杂着Python环境路径的小坑，我来帮你拆解分析下：

首先说核心问题——你的subprocess命令写法不对！当使用shell=True时，如果你传的是列表形式的cmd，shell会把列表的第一个元素当作要执行的命令，剩下的元素全部当作这个命令的参数。也就是说，那些|、grep、xargs都会被当成git diff的参数，而不是shell管道的一部分，这完全偏离了你想要的逻辑，自然不会执行Black格式化。

给你几个可行的解决方案：

方案1：修正shell命令的传参方式 #

把整个管道命令写成一个完整的字符串，而不是拆分的列表，这样shell才能正确解析管道符号：

def run_black() -> None:
    """Runs black formatter."""
    cmd = "git diff --cached --name-only --diff-filter=d | grep -E \\.py$ | xargs black --skip-string-normalization"
    subprocess.run(cmd, shell=True, check=True, text=True)

方案2：避免shell管道，用Python逻辑处理（更推荐） #

依赖shell管道容易带来环境兼容性问题，调试也麻烦。你可以用Python分步处理文件列表，完全绕开shell：

def run_black() -> None:
    """Runs black formatter."""
    # 第一步：获取暂存区中未被删除的文件列表
    git_diff = subprocess.run(
        ["git", "diff", "--cached", "--name-only", "--diff-filter=d"],
        capture_output=True,
        text=True,
        check=True
    )
    # 第二步：筛选出Python文件
    py_files = [file.strip() for file in git_diff.stdout.splitlines() if file.endswith(".py")]
    
    if not py_files:
        print("No Python files to format.")
        return
    
    # 第三步：调用Black格式化这些文件
    subprocess.run(
        ["black", "--skip-string-normalization"] + py_files,
        check=True,
        text=True
    )

这种方式更可控，还能随时打印中间结果（比如py_files）排查问题，避免shell环境带来的不确定性。

额外解决环境路径问题 #

你提到sys.executable和实际使用的direnv环境不一致，这可能导致subprocess调用的Black不是你环境里的版本。如果用方案2，可以直接指定Black的绝对路径，确保调用的是目标环境里的工具：

["/home/dev/opensource/.direnv/python-3.9.20/bin/black", "--skip-string-normalization"] + py_files

备注：内容来源于stack exchange，提问作者DeviantG