使用pdf.savefig保存Matplotlib饼图至PDF时出现文件占用报错

核心问题分析与修复方案 #

• 文件句柄未释放：这是最常见的原因。使用PdfPages时若未正确关闭文件对象，Python进程会一直占用该PDF，导致无法打开。
  正确代码示例：

  from matplotlib.backends.backend_pdf import PdfPages
  import matplotlib.pyplot as plt
  import pandas as pd
  
  # 读取爬虫生成的CSV
  df = pd.read_csv("your_data.csv")
  # 绘制饼图
  plt.pie(df['value_column'], labels=df['label_column'])
  plt.title("数据分布饼图")
  
  # 用with语句自动管理PdfPages，无需手动关闭
  with PdfPages("pie_chart.pdf") as pdf:
      pdf.savefig()  # 保存当前画布到PDF
  plt.show()  # 显示图表，放在保存之后不影响
  

  with语句会在代码块结束后自动关闭PdfPages，彻底释放文件占用。

• plt.show()的位置错误：若在pdf.savefig()前调用plt.show()，Matplotlib会清空当前画布并创建新窗口，导致保存的PDF为空或损坏。务必先执行保存操作，再调用plt.show()。

• 残留进程占用：如果之前的Python程序异常退出，可能有残留进程拿着文件锁。打开任务管理器，结束所有Python相关进程后再重新运行代码。

• 路径与权限问题：确保保存PDF的路径有写入权限，避免存放在系统保护目录（如C:\Windows），文件名不要包含中文或特殊字符（如/、:）。

验证步骤 #

1. 运行修正后的代码，检查生成的PDF文件大小，若大于0KB则保存成功。
2. 尝试打开PDF，若仍报错，重启Python解释器或电脑后再试。

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