Mac系统使用docx2pdf转换docx为PDF时出现进度条错误求助

核心原因 #

这个进度条卡住的问题，本质是docx2pdf依赖的转换引擎（Microsoft Word或LibreOffice）无法正常调用，或者文件/权限存在阻碍。

具体解决步骤 #

• 确认依赖引擎状态

  • 若使用Microsoft Word：确保Word已正常安装，能手动打开目标my.docx文件（排除文件损坏），且路径无误。
  • 若使用LibreOffice：先通过Homebrew安装（未装Homebrew需先安装）：

    brew install libreoffice
    

    然后修改代码指定引擎：

    from docx2pdf import convert
    convert('my.docx', engine='libreoffice')
    

• 检查文件路径与系统权限

  • 避免相对路径出错，直接使用文件绝对路径，比如/Users/你的用户名/Documents/my.docx
  • 给运行代码的终端/IDE开启完全磁盘访问权限：打开「系统偏好设置」→「安全性与隐私」→「隐私」→「完全磁盘访问」，添加终端或你用的开发工具（如VS Code）

• 清理Word残留进程
  若之前Word异常退出，可能残留后台进程导致无法调用：打开「活动监视器」，搜索Microsoft Word，结束所有相关进程后重新运行代码

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