MacOS构建js-dossier时Bazel提示python未定义的问题求助

问题概述 #

• 环境：MacOS系统，已安装Bazel
• 操作：尝试构建js-dossier项目，执行构建脚本./gendossier.sh -r
• 核心错误：Bazel提示「无法运行程序"python"，无此文件或目录」
• 已做操作：在.bashrc中设置alias python=python3，终端验证该命令可正常运行；确认/private/var/tmp/_bazel_erikn/4521f4523bde805bb0b44649cb6641b5/external/maven目录及aopalliance-1.0.jar文件存在
• 疑问：如何排查该构建问题？是否需要先系统学习Bazel或Maven？

解决Python找不到的核心问题 #

Bazel不会读取shell的alias配置（它是直接调用系统命令，而非在你的bash环境中执行），所以你设置的别名对Bazel无效，用以下两种方法解决：

1. 创建Python软链接（推荐） #

在终端执行命令，让系统python命令指向python3：

sudo ln -s /usr/bin/python3 /usr/local/bin/python

2. 给Bazel指定Python路径 #

• 方法一：修改项目的.bazelrc配置文件，添加一行：

  build --python_path=/usr/bin/python3
  

• 方法二：执行构建时临时指定参数（如果gendossier.sh里调用了Bazel，也可以直接修改脚本中的Bazel命令，加上该参数）：

  bazel build --python_path=/usr/bin/python3 //...
  

后续排查步骤（若解决Python问题后仍有报错） #

1. 清理Bazel缓存：缓存可能导致依赖异常，执行命令清理后重新构建：

   bazel clean
   

2. 核对项目文档：查看js-dossier项目的README或构建说明，确认MacOS环境下有没有特殊的依赖安装或配置要求。

是否需要先学习Bazel/Maven？ #

不需要先系统学习，先聚焦解决当前的具体问题即可。等项目成功构建后，若后续频繁使用这类工具再系统学习也不迟。当前只需了解两个基础点：

• Bazel是构建工具，负责项目编译、依赖管理；
• Maven是Java生态的依赖管理工具，该项目可能用它拉取Java相关依赖。

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