Pants运行Python应用报错：remote install is not supported on this platform!

问题重现 #

在M2 Pro MacBook上使用Pants运行Python应用时，执行pants run main.py触发如下错误，但pants version、pants help等命令可正常执行：

saygin@mbpro trial-project % pants run main.py
[INFO scie_pants] Found Pants build root at Some("/Users/saygin/dev")
[INFO scie_pants] The required Pants version is Some("2.21.0a1")
remote install is not supported on this platform!
saygin@mbpro trial-project %

先后测试Pants 2.17.0和2.21.0a1版本均出现该问题，怀疑与M2 Pro的arm64平台相关。

解决方案 #

1. 禁用远程安装/缓存配置 #

Pants的远程安装逻辑在arm64 macOS平台上可能存在兼容性问题，尤其是预发布版本。修改项目根目录的pants.toml，添加或更新以下配置：

[GLOBAL]
remote_cache = false
remote_execution = false

保存后重新运行pants run main.py。

2. 切换至稳定版Pants #

2.21.0a1是alpha预发布版本，存在未修复的平台兼容性问题。建议降级至最新稳定版（如2.20.x系列）：

• 删除项目中的.pants.d目录，清理旧环境
• 修改pants.toml中的pants_version为稳定版，例如：

  [GLOBAL]
  pants_version = "2.20.0"
  

• 重新执行pants run main.py

3. 验证Python解释器的arm64兼容性 #

确保项目使用的Python解释器支持arm64架构：

• 在pants.toml中明确指定兼容的Python版本范围：

  [python]
  interpreter_constraints = ["CPython>=3.8,<3.12"]
  

• 运行pants python-interpreter list查看可用解释器，确认存在arm64版本的Python（标注为arm64或aarch64）

4. 强制本地存储路径 #

设置环境变量指定Pants的本地存储目录，避免触发远程安装逻辑：

export PANTS_LOCAL_STORE_DIR="$HOME/.pants/local_store"

执行上述命令后，重新运行pants run main.py

内容的提问来源于stack exchange，提问作者sayginify