pipenv run执行脚本提示PATH找不到命令，pipenv shell可正常运行

使用pipenv run <命令脚本>执行命令时，报错提示对应命令不在PATH中；但进入pipenv shell后执行相同命令却能成功，想了解这两种执行方式的差异。

控制台输出 #

通过pipenv run <命令脚本>执行失败 #

# pipenv run执行失败的情况
% pipenv run lint --system
Error: the command black --check . (from lint) could not be found within PATH.

通过pipenv shell后执行成功 #

# 进入pipenv shell后执行相同命令成功
% pipenv shell
Launching subshell in virtual environment...
 . /Users/clayton/.local/share/virtualenvs/web-personal-fOXGPF80/bin/activate
Fri Aug  5 17:14:42 CEST 2022

% black --check .
All done! ✨ 🍰 ✨
9 files would be left unchanged.

Pipfile配置 #

[[source]]
url = "https://pypi.org/simple"
verify_ssl = true
name = "pypi"

[packages]
tornado = ">=6.2"
markdown2 = ">=2.4"
pyyaml = ">=6.0"
pyfiglet = ">=0.8"
colorama = ">=0.4"
gunicorn = ">=20.1"

[dev-packages]
black = "*"
pylint = "*"

[requires]
python_version = "3.10"

[scripts]
lint = ["black --check .", "pylint $(git ls-files '*.py')"]

原因及解决方法 #

核心差异 #

pipenv run和pipenv shell的环境变量处理逻辑完全不同：

• pipenv shell会先加载系统shell的全部配置（比如.bashrc/.zshrc），再激活虚拟环境，虚拟环境的bin目录会被正确加入PATH，同时保留系统原有PATH的完整配置。
• pipenv run则是直接在当前环境基础上，仅添加虚拟环境的bin目录，不会加载任何shell配置脚本。如果脚本依赖shell扩展语法，或者命令查找依赖系统PATH的额外配置，就会出现问题。

具体问题分析 #

你的Pipfile里的lint脚本存在两个关键问题：

1. 列表格式不支持shell语法：Pipenv的[scripts]如果用列表（["cmd1", "cmd2"]），会把每个元素当作独立命令直接执行，不经过shell解析，导致$(git ls-files '*.py')这种变量替换语法失效，同时black命令的路径查找也会因为PATH处理逻辑出错而失败。
2. 命令拆分方式错误：列表格式下，每个命令应该拆分为单独的参数数组，而非完整的命令字符串，否则Pipenv会把整个字符串当作一个命令去查找，自然找不到匹配的可执行文件。

修复方案 #

把lint脚本改成字符串格式，让Pipenv通过系统shell执行整个命令：

[scripts]
lint = "black --check . && pylint $(git ls-files '*.py')"

这种写法既支持$(git ls-files)这类shell扩展，也能让Pipenv正确识别虚拟环境中的black和pylint命令。

如果坚持使用列表格式，需要将每个命令拆分为无shell语法的参数数组，但这种方式依然不支持变量替换，仅适用于简单命令：

[scripts]
lint = ["black", "--check", ".", "&&", "pylint", "your_python_files_here"]

内容的提问来源于stack exchange，提问作者Clayton J Roberts