Python-docx库导入异常及表格样式设置问题求助

1. 处理VS Code的「Import 'docx' could not be resolved」提示 #

• 先核对VS Code使用的Python解释器和你安装python-docx的环境是否一致：
  1. 点击VS Code左下角显示的Python版本（比如3.9.7）
  2. 在弹出的列表里选择你安装了python-docx的环境（包括虚拟环境）
• 要是你全局安装了python-docx，但VS Code默认用了系统自带Python：
  终端运行which python3拿到安装路径，然后按Cmd+Shift+P打开命令面板，输入Python: Select Interpreter，手动指定这个路径即可。

2. 消除table.style = 'TableGrid'的弃用警告 #

python-docx 0.8.11里直接用'TableGrid'赋值样式已被弃用，正确写法是使用带空格的样式名'Table Grid'：

from docx import Document

doc = Document()
table = doc.add_table(rows=2, cols=2)
# 正确样式名称是「Table Grid」
table.style = 'Table Grid'
# 或者通过文档样式对象获取，更稳妥
table.style = doc.styles['Table Grid']

改完后弃用警告就会消失。

3. 解决from docx.oxml.table import CT_TableStyle的ImportError #

python-docx 0.8.11中，CT_TableStyle的正确导入路径是docx.oxml，而非docx.oxml.table：

from docx.oxml import CT_TableStyle

不过大多数场景下根本不需要手动导入这个底层类，用上面的table.style赋值就能搞定表格样式设置，没必要碰底层OXML接口。

虚拟环境问题排查 #

如果创建虚拟环境后问题依旧：

• 激活虚拟环境后，重新执行pip install python-docx==0.8.11确保包安装正确
• 激活环境后运行pip list，确认python-docx出现在列表里
• 在VS Code中切换到虚拟环境的Python解释器（路径通常是你的虚拟环境目录/venv/bin/python3）

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