使用pip安装fbprophet报错、pystan安装正常的问题咨询

Python版本适配要求 #

不同版本的fbprophet（1.0版本后PyPI包名更改为prophet）对Python版本有严格适配要求，版本不匹配会直接触发编译/安装报错：

• 0.6及更早版本fbprophet：仅适配Python 3.6~3.7
• 0.7.1版本（fbprophet最终停更版本）：适配Python 3.6~3.8
• 1.0及以上版本（更名后为prophet）：适配Python 3.7_{3.11，推荐使用3.8}3.10版本安装，兼容性最佳

直接执行pip install fbprophet默认拉取的是2020年就停更的0.6版本，本身存在大量未修复的环境兼容问题，是绝大多数人安装失败的核心诱因。

纯pip环境安装操作步骤 #

以下步骤经过多环境验证，不需要依赖Anaconda即可完成部署：

1. 先清理环境内残留的冲突依赖
   执行以下命令卸载所有历史版本的相关包，避免版本冲突：

   pip uninstall -y pystan fbprophet prophet cmdstanpy
   

2. 安装固定版本的编译依赖
   pystan和prophet/fbprophet存在严格的版本绑定关系，随意安装不同版本pystan必然触发编译错误，无需测试多个pystan版本，直接安装对应固定版本即可：

   # 安装编译所需的基础依赖
   pip install Cython numpy==1.23.5
   # 安装适配的pystan版本，不要更换版本号
   pip install pystan==2.19.1.1
   

   Windows用户注意：执行上述命令前需要先安装Visual Studio 2019生成工具，勾选「使用C的桌面开发」组件完成安装，否则C编译环节会直接报错。
3. 验证pystan功能正常
   运行以下Python代码，无报错则说明pystan环境配置正确：

   import pystan
   test_model = pystan.StanModel(model_code="parameters {real y;} model {y ~ normal(0,1);}")
   print("pystan环境校验通过")
   

4. 安装目标包
   根据自己的需求选择对应安装命令，不要混用：

   # 推荐：安装维护中的稳定新版prophet
   pip install prophet==1.1.5
   
   # 若必须使用旧版fbprophet，执行此命令安装最终兼容版本，不要直接pip install fbprophet
   pip install fbprophet==0.7.1
   

常见问题说明 #

• 安装时如果提示权限不足，在pip命令后加--user参数即可，不要使用sudo修改全局Python环境，避免触发更多权限问题
• Python3.9及以上版本无法安装0.7.1及更早的fbprophet版本，无兼容解决方案，要么换低版本Python，要么使用新版prophet
• 安装过程中如果出现下载超时，可在pip命令后加-i https://pypi.tuna.tsinghua.edu.cn/simple使用国内源加速

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