macOS环境Django项目安装python3-magic报错问题咨询

报错核心原因 #

python3-magic是Debian/Ubuntu系统apt软件源里的系统包命名，PyPI官方源中不存在这个名称的Python包，直接用pip安装必然返回找不到分发版本的错误。同时python-magic依赖系统层面的libmagic底层库，macOS需要先通过Homebrew安装该系统依赖才能正常使用Python绑定。

具体安装步骤 #

• 安装系统底层依赖
  打开终端执行Homebrew命令安装libmagic：

  brew install libmagic
  

  若本地未安装Homebrew，先完成Homebrew环境部署后再执行上述命令即可。
• 安装Python侧依赖包
  首先激活你Django项目使用的Python虚拟环境（必须和VS Code中项目选中的解释器环境一致，否则会出现装了但识别不到的问题），执行以下命令安装正确名称的PyPI包：

  pip install python-magic
  # 若环境默认pip指向Python2，就用pip3
  pip3 install python-magic
  

• VS Code识别异常修复
  若安装完成后VS Code仍提示包未安装，按以下规则排查：
  • 查看VS Code窗口左下角显示的Python解释器路径，确认和你刚才执行pip装包的环境路径完全一致，不要出现包装在全局Python、但项目选了虚拟环境解释器的路径错配问题
  • 按Cmd+Shift+P快捷键调出命令面板，搜索执行Python: Select Interpreter选项，重新选中你Django项目对应虚拟环境的解释器，重启VS Code窗口即可

常见问题处理 #

• 若执行import magic时提示找不到libmagic动态库，执行brew info libmagic查看libmagic的实际安装路径，将该路径下的lib目录添加到系统DYLD_FALLBACK_LIBRARY_PATH环境变量中即可解决。

安装验证 #

在激活的虚拟环境中打开Python交互终端，执行import magic无报错即代表安装成功，可直接在Django项目代码中正常导入使用。

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