QAxObject 连接 Word 失败主因是位数不匹配或 COM 未注册，需确保 Qt 与 Office 位数一致、Word.Application 在注册表存在；中文格式错乱须显式设字体并用 UTF-16；表格插入需严格参数类型与顺序；进程残留必须显式调用 Quit() 和 clear()。
QAxObject 连接 Word 实例失败，提示“Class not registered”
这通常不是代码问题，而是 Word 未正确注册 COM 组件或当前环境不支持。64 位 Qt 程序无法调用 32 位 Office（反之亦然），必须严格匹配位数。QAxObject 依赖系统已安装且注册的 Word COM 接口，若用的是 Microsoft 365 订阅版、Click-to-Run 安装方式，很可能默认未注册 Word.Application 类。
实操建议：
- 先在 PowerShell 中运行
Get-ChildItem "HKCR:\Word.Application\CLSID" -ErrorAction SilentlyContinue，确认注册表存在该键；不存在则需修复 Office 或改用传统 MSI 安装包 - Qt 构建套件必须与 Office 位数一致：查
WINWORD.EXE属性 → “兼容性” → “更改高 DPI 设置”旁点“查看详细信息”，看“体系结构”是 x64 还是 x86 - 避免在无桌面会话的 Windows Server 或远程桌面断开后调用 ——
Word.Application需要交互式桌面会话才能启动
创建文档后插入文字但格式错乱、中文字体丢失
Word COM 接口默认使用英文区域设置和 Calibri 字体，直接赋值 Range.Text 不带样式控制，中文容易回退为宋体或显示为方块。更关键的是，Selection 和 Range 的光标位置极易被忽略，导致文字插到意外位置。
实操建议：
- 显式设置字体：对目标
Range对象调用Font.Name = "微软雅黑"、Font.Size = 10.5，注意 Name 是字符串，不是整数 ID - 避免依赖
Selection：不用word->dynamicCall("Selection()")，改用Documents->item(1)->Content->Range()获取正文范围再操作 - 插入段落前先调用
Range.Collapse(0)（0 表示折叠到起点），否则可能在段中插入造成格式污染 - 中文内容务必用
QString::fromUtf8()确保传入的是 UTF-16（COM 接口实际接收的是 BSTR，Qt 自动转换，但源字符串编码错误会导致乱码）
生成多页报告时表格插入失败或行列错位
Tables.Add() 的参数顺序和类型非常敏感：第 3、4 个参数是行数、列数（整数），但第 1 个参数是 Range，第 2 个是宽度（单位是磅，不是像素），第 5 个开始才是可选参数如 DefaultTableBehavior。漏传或类型错（比如传了 double 当 int）会导致 COM 调用静默失败或崩溃。
实操建议：
- 表格必须插入到有效
Range：不能直接插到Document.Content末尾就完事，先Range.Collapse(0)再Range.InsertParagraphAfter()，然后取新段落的Range作为插入点 - 行列数必须是
QVariant::Int类型：用QVariant(3)，不要用QVariant(3.0)或隐式转换的int变量（Qt 的 COM 封装对 QVariant 类型校验较严） - 设列宽推荐用
AutoFitBehavior(1)（wdAutoFitContent），比手动算磅数可靠；如需固定宽度，用Table.Columns.Item(i)->SetWidth(w, 1)，第二个参数是单位（1=磅） - 表格内填文本，务必用
Cell.Range.Text = "内容"，别用Cell.Range.InsertAfter()，后者会在单元格末尾追加换行，破坏布局
程序退出时 Word 进程残留、CPU 占用 100%
这是最典型的资源泄漏：Qt 的 QAxObject 不会自动释放 COM 接口引用，尤其当对象链存在嵌套（如 Documents→Document→Content→Range→Font）时，任意一环没调 clear() 或没让对象析构，Word 进程就会卡住。
实操建议：
- 所有中间
QAxObject*必须显式delete或作用域结束前调clear()；不要依赖 RAII，因为QAxObject析构函数不保证释放 COM 接口 - 关闭文档必须用
doc->dynamicCall("Close(QVariant)", QVariant(false))（false 表示不保存），不能只调doc->deleteLater() - 退出前必须调
word->dynamicCall("Quit()")，且之后立即对word调clear()；如果中途异常，也要在catch块里补上 - 调试时用任务管理器观察
WINWORD.EXE进程数，每次生成后应为 0；若仍有残留，用Process Explorer查看句柄归属，定位哪个QAxObject没释放
COM 调用的脆弱性远高于普通 Qt 对象操作，每个 dynamicCall 都可能因参数类型、顺序、生命周期引发不可见故障。宁可多写几行 clear() 和 try/catch，也不要依赖“应该没问题”。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
