Zeppelin Notebook无法使用Python的故障排查求助

核心问题是Zeppelin进程无法识别你在.zshrc里设置的python别名——shell别名仅对交互式终端会话生效，而Zeppelin作为Java后台进程启动时，不会加载用户shell的配置文件（比如.zshrc）。M1 Mac默认没有名为python的可执行文件，只有python3，所以Zeppelin调用python命令时会触发"找不到文件"的错误。

方法1：创建python到python3的软链接 #

直接在系统全局路径中建立软链接，让所有进程都能通过python命令调用python3：

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

执行后验证：终端输入python --version，应与python3 --version输出一致。

方法2：在Zeppelin中指定Python解释器路径 #

如果不想修改系统软链接，可直接在Zeppelin的Python解释器配置里指定python3的绝对路径：

1. 打开Zeppelin Web UI，点击右上角的Interpreter菜单。
2. 找到python解释器，点击Edit按钮。
3. 在Properties区域，找到python.command配置项，将值改为/usr/bin/python3（或通过which python3命令查看的实际路径）。
4. 点击Save，重启Zeppelin服务后测试Notebook代码。

方法3：让Zeppelin启动时加载shell环境变量 #

如果需要保留.zshrc的配置，可修改Zeppelin的启动脚本，使其以交互式shell启动：

1. 找到Zeppelin的启动脚本（通常在ZEPPELIN_HOME/bin/zeppelin-daemon.sh）。
2. 找到脚本中Java启动的行，将其改为通过zsh加载配置后启动：

exec /bin/zsh -l -c "$JAVA ..."

（注：需替换原脚本中的Java启动命令，确保完整保留原参数）

• 修正SPARK_HOME配置：你的.zshrc里export SPARK_HOME=/Users//Documents/Projects/spark/spark-3.1.3-bin-hadoop3.2存在多余斜杠，应改为/Users/你的用户名/Documents/Projects/spark/spark-3.1.3-bin-hadoop3.2；同时确保Zeppelin进程能读取到这个环境变量（可通过方法3加载shell配置，或在Zeppelin的Interpreter设置中手动配置SPARK_HOME）。
• 确认Zeppelin运行用户：如果Zeppelin以root或其他用户启动，可能无法读取当前用户的.zshrc，需确保Zeppelin以你的用户身份启动。

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