PyInstaller打包后提示PortAudio库缺失，libportaudio64bit.dll放置咨询

我之前踩过一模一样的坑！Python脚本跑起来完全正常，打包成exe就报OSError: PortAudio library not found，其实根源是PyInstaller默认不会自动识别sounddevice藏在_sounddevice_data里的PortAudio动态库——而且你找到的libportaudio64bit.dll完全是对的，这就是sounddevice在64位Windows环境下用的官方库，不用改名字。

为什么放到site-packages没用？ #

PyInstaller打包时只会扫描常规site-packages下的模块和已知依赖，_sounddevice_data属于sounddevice的私有数据目录，不在默认扫描范围内，所以你复制到site-packages也不会被打包进去。

可行的解决方案 #

我给你三个亲测有效的方法，按需选择：

• 方法1：打包时手动指定要添加的dll（最推荐）
  直接在PyInstaller命令里用--add-data参数把dll打包进去，Windows环境下用分号;分隔源路径和目标路径，命令格式如下：

  pyinstaller --add-data "E:\python\Lib\site-packages\_sounddevice_data\portaudio-binaries\libportaudio64bit.dll;." your_script.py
  

  这里的.;表示把dll放到打包后的输出目录根目录（和exe同级别），如果用--onefile模式打包，PyInstaller会自动把dll解压到临时运行目录，不用额外调整。

• 方法2：在脚本中手动指定PortAudio路径（适合复杂场景）
  如果你的脚本需要同时适配打包和非打包两种环境，可以在导入sounddevice前加一段代码，手动设置环境变量让程序找到dll：

  import os
  import sys
  
  # 判断是否是打包后的exe运行环境
  if getattr(sys, 'frozen', False):
      # sys._MEIPASS是PyInstaller打包后临时解压的目录
      dll_dir = os.path.join(sys._MEIPASS, '')
      # 把dll所在目录加入系统PATH
      os.environ['PATH'] = dll_dir + os.pathsep + os.environ['PATH']
  
  # 现在再导入sounddevice
  import sounddevice as sd
  

  用这个方法的话，还是需要配合方法1的--add-data参数把dll打包进去。

• 方法3：手动复制dll到exe目录（临时测试用）
  如果你只是临时测试，不想改打包命令，可以直接把libportaudio64bit.dll复制到打包生成的exe文件同一个文件夹里，运行exe时就能自动找到这个dll了。

额外注意事项 #

• 如果你用的是32位Python，对应的dll应该是32位版本（名字可能是libportaudio32bit.dll），别搞混了；
• 如果用--onefile打包后还是报错，检查一下--add-data的路径有没有写错，路径里的空格要加引号；
• 确保你的Python版本和dll的位数一致（64位Python配64位dll，32位配32位）。

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