FPDF2导入报错：cannot import name 'FPDF' from 'fpdf'问题求助

第一步：排查命名冲突 #

• 先检查你当前运行代码的目录下，是否存在命名为fpdf.py的文件，或是名为fpdf的文件夹，如果有直接重命名为其他名称（比如fpdf_demo.py），同时删除同目录下自动生成的__pycache__文件夹。这类本地同名文件会被Python优先导入，直接覆盖你安装的第三方fpdf2包，是这类导入错误最常见的诱因。

第二步：确认包安装路径和运行环境匹配 #

使用conda管理多环境时，很容易出现包安装的环境和实际运行代码的环境不匹配的问题，按以下步骤校验：

• 在你当前运行代码的终端/Notebook中执行以下代码，输出当前使用的Python路径：

import sys
print(sys.executable)

• 复制上一步输出的完整Python路径，执行以下定向安装命令，保证fpdf2安装到你正在使用的环境中：

# 把<你复制的Python路径>替换成上一步输出的实际路径即可
<你复制的Python路径> -m pip install fpdf2==2.3.1

第三步：清理旧包残留 #

早期的原版fpdf包和fpdf2存在命名冲突，如果之前安装过旧版fpdf也会触发该错误：

• 执行以下命令完全卸载所有相关包：

pip uninstall -y fpdf fpdf2
conda uninstall -y fpdf fpdf2

• 卸载完成后再重新执行第二步的定向安装命令即可。

验证修复 #

安装完成后重启你的代码运行环境（比如重启Jupyter内核、重启Python终端），再运行from fpdf import FPDF即可正常导入。

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