MacBook M1环境下已安装Python pandocfilter模块提示未找到问题求助

1. 确认pandocfilters安装路径与Python版本匹配 #

• 执行which python3获取当前Python3的实际路径，M1芯片Mac通过Homebrew安装的Python3默认路径为/opt/homebrew/bin/python3，与Intel芯片的/usr/local/bin/python3路径存在差异
• 执行对应版本的pip查询包安装情况：{上一步输出的Python3路径} -m pip list | grep pandocfilters，无输出则说明pandocfilters未安装到当前Python3的依赖库中
• 直接用当前Python3对应的pip重装依赖：python3 -m pip install pandocfilters，避免直接执行pip3 install导致pip与python3指向的版本不匹配

2. 验证脚本自身加载能力 #

• 给脚本添加可执行权限：chmod +x 你的脚本文件名.py
• 直接执行脚本测试模块加载：./你的脚本文件名.py，执行后无报错仅处于等待输入状态为正常，说明模块加载无问题，故障出在pandoc调用环节
• 如果执行后仍报模块找不到，检查脚本第一行的#!/usr/bin/env python3是否为文件首个内容，前面不能有空行或其他字符，否则shebang不生效

3. 修复pandoc调用时的环境变量差异 #

pandoc调用过滤器时使用非交互shell，不会加载终端的自定义PATH配置，可能会 fallback 到系统预装的Python3，而系统Python3未安装pandocfilters，可通过两种方式规避：

• 调用pandoc时直接指定解释器执行脚本：pandoc 输入文件 -o 输出文件 --filter="python3 你的脚本绝对路径.py"
• 直接写死Homebrew Python3路径调用：pandoc 输入文件 -o 输出文件 --filter="/opt/homebrew/bin/python3 你的脚本绝对路径.py"

4. 快速定位验证方法 #

在脚本开头加入以下代码，运行pandoc时查看stderr输出的Python路径是否为预期的3.9.7版本：

import sys
print(sys.executable, file=sys.stderr)

输出路径不符的话按上面的路径指定方案修正即可。

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