Mac下PySpark安装启动故障排查：解决'pyspark命令未找到'问题

核心原因 #

pyspark命令位于你配置的$SPARK_PATH/bin目录下，但该目录未被添加到系统的PATH环境变量中，导致bash无法定位到这个命令。

解决方案一：完善环境变量配置 #

1. 打开你的.bash_profile文件：

   open ~/.bash_profile
   

2. 在已有的配置下方添加PATH配置行：

   export PATH=$SPARK_PATH/bin:$PATH
   

   最终完整配置如下：

   export SPARK_PATH=~/spark-3.3.0-bin-hadoop2.6 
   export PYSPARK_DRIVER_PYTHON="jupyter" 
   export PYSPARK_DRIVER_PYTHON_OPTS="notebook"
   export PATH=$SPARK_PATH/bin:$PATH
   

3. 让配置立即生效：

   source ~/.bash_profile
   

4. 验证配置：
   执行echo $PATH查看输出，确认~/spark-3.3.0-bin-hadoop2.6/bin已包含在路径中，随后执行pyspark即可启动会话。

解决方案二：使用pip安装PySpark（更简便） #

手动下载解压的方式需要手动维护环境变量，推荐直接通过pip安装，系统会自动处理命令路径：

pip install pyspark

安装完成后直接执行pyspark即可，无需额外配置SPARK_PATH。

额外注意事项 #

如果你的Mac默认终端是zsh（而非bash），需要将上述配置添加到~/.zshrc文件中，而非.bash_profile，添加后执行source ~/.zshrc使配置生效。

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