Pants构建系统中mypy沙箱执行路径问题的技术分析

在Pants构建系统的Python后端中，当使用mypy进行类型检查时，系统会创建一个临时沙箱环境来执行检查任务。最近发现了一个有趣的技术问题：沙箱中的__run.sh脚本在手动执行时会失败，但在Pants自动执行时却能正常工作。

问题现象

当用户手动执行沙箱目录中的__run.sh脚本时，会遇到"__mypy_runner.sh: No such file or directory"的错误提示。这个脚本包含类似env -i ... __mypy_runner.sh的命令行，其中__mypy_runner.sh使用的是相对路径，但没有指定路径前缀。

技术背景

这个问题涉及到Unix/Linux系统中程序执行的底层机制差异。关键点在于：

1. execvp系统调用：这是Pants实际使用的底层执行机制。当PATH环境变量未设置且路径中不包含斜杠时，execvp会默认将路径视为相对路径。

2. Bash的行为：与execvp不同，当PATH未设置且路径中无斜杠时，Bash不会尝试将其作为相对路径处理，而是直接报错。

深入分析

在Pants的实现中，使用Rust的std::process::Command::spawn最终会调用execvp。execvp的特殊行为使得即使没有设置PATH且使用相对路径，执行也能成功。而当我们手动使用Bash执行相同命令时，由于Bash的不同处理逻辑，导致执行失败。

这种差异解释了为什么Pants能正常工作而手动执行会失败。这也提醒我们在编写跨平台构建工具时，需要特别注意不同执行环境下的行为差异。

解决方案

对于构建系统开发者来说，最佳实践是：

1. 显式指定脚本的完整路径，避免依赖执行环境的特殊行为
2. 在沙箱环境中确保PATH设置正确
3. 对关键路径进行明确的相对或绝对路径指定

这个问题虽然不影响Pants的正常使用，但揭示了构建系统中环境隔离和路径处理的重要细节，对于理解构建系统的内部工作机制很有帮助。