comtypes调用Word COM失败主因是环境未配好：需安装与Python位数一致的桌面版Word，手动首次运行完成COM注册，并设Visible=False和DisplayAlerts=0避免弹窗；SaveAs导出PDF须用FileFormat=17，路径用原始字符串，且必须调用doc.Close()和word.Quit()释放进程。
comtypes调用Word COM对象失败：常见报错和前置条件
直接运行 comtypes 脚本却提示 pywintypes.com_error 或 “找不到指定的模块”，大概率不是代码问题，而是环境没配好。Windows 上必须已安装 Microsoft Word（非仅 Office Online 或 WPS），且是 32/64 位与 Python 一致的版本——比如 64 位 Python 就不能调 32 位 Word。
验证方式很简单：在 PowerShell 中执行 Get-AppxPackage -Name "*Office*" 看是否返回桌面版 Office；再用 python -c "import platform; print(platform.architecture())" 确认 Python 架构。
- Word 必须是完整桌面版（含 Word.exe），Microsoft 365 订阅版默认满足，但“精简版”或 Click-to-Run 单独安装的 Word 可能缺 COM 注册
- 首次运行前建议手动打开一次 Word，让它完成初始化和 COM 注册
- 若用虚拟环境，确保
comtypes已安装：pip install comtypes
核心转换逻辑：用 Documents.Open + SaveAs 导出 PDF
COM 接口不提供直接“转 PDF”函数，本质是模拟人工操作：打开文档 → 调用 Word 内置导出功能 → 保存为 PDF。关键在于 SaveAs 的 FileFormat 参数必须设为 17（对应 wdFormatPDF），不是字符串也不是常量名。
from comtypes import client
word = client.CreateObject("Word.Application")
doc = word.Documents.Open(r"C:\path\to\input.docx")
doc.SaveAs(r"C:\path\to\output.pdf", FileFormat=17) # 注意：17 是 wdFormatPDF 的整数值
doc.Close()
word.Quit()-
FileFormat=17是硬编码值，comtypes不自动导入 Word 常量，别写成wdFormatPDF或"PDF" - 路径必须用原始字符串（
r""）或双反斜杠，否则\n类转义会出错 - 务必调用
doc.Close()和word.Quit()，否则 Word 进程残留，下次运行可能卡死或报错“文档已被锁定”
静默运行与异常处理：避免弹窗和崩溃
默认情况下，Word 启动会显示界面、弹出警告（如宏禁用提示、字体缺失提示），这会导致脚本卡住。必须显式设置 Visible=False 和关闭警告提示。
立即学习“Python免费学习笔记（深入）”；
word = client.CreateObject("Word.Application")
word.Visible = False
word.DisplayAlerts = 0 # 0 = wdAlertsNone，禁止所有弹窗-
DisplayAlerts = 0是关键，否则遇到缺失字体、不兼容格式时会停在 GUI 提示框上 - 加
try/finally确保即使出错也释放 Word 进程： - 用
os.path.exists()检查输出 PDF 是否生成成功，因为SaveAs即使失败也可能不抛异常（尤其权限不足时）
替代方案提醒：为什么有时不该用 comtypes
这个方法依赖本地 Word，意味着无法部署到 Linux 服务器、Docker 容器或无 GUI 的 CI 环境。如果只是简单排版（无复杂样式、公式、OLE 对象），更轻量的选择是 python-docx + weasyprint 或 docxtopdf（底层调用 LibreOffice）。但注意：docxtopdf 在 Windows 上仍需 LibreOffice 安装，且对页眉页脚、分栏支持弱于原生 Word。
真正需要 comtypes 的场景其实很窄：必须保留 Word 原有渲染效果（比如公司红头文件模板、带 ActiveX 控件的表单、精确打印控制）。其他情况，先问自己一句：PDF 是给人看还是给系统读？后者往往用 HTML + wkhtmltopdf 更稳。
