wps-format-fix

WPS 格式兼容性修复

修复 WPS ↔ Microsoft Office 之间互传文档时的各种格式错乱问题。

这是 WPS 用户反馈最多的痛点。 本工具提供系统性的诊断和修复方案。

When to Use

• 文档在WPS打开后格式错乱
• Word文件发给对方后排版变了
• 字体显示不对/缺失
• 行距、页边距、表格等格式异常
• 用户说"格式乱了""打开变了""兼容性问题"

When NOT to Use

• 需要从头创建文档 → 使用 wps-docx-writer
• 需要公文排版 → 使用 wps-gongwen
• 需要校对文字内容 → 使用 wps-proofread

常见问题诊断表

症状	原因	修复方案
字体变了/显示方块	对方电脑没有该字体	字体替换为通用字体
行距忽大忽小	WPS和Word的行距计算方式不同	统一设置固定行距
表格超出页面	表格宽度计算差异	重设表格宽度为百分比
图片位移/重叠	图片锚定方式不同	改为嵌入型排列
页面布局错乱	分节符/分页符差异	重设页面参数
页码不连续	节设置差异	统一节的页码设置
目录页码错误	域代码未更新	更新所有域
SmartArt变形	WPS渲染差异	转换为普通形状
公式显示异常	MathType/公式编辑器兼容性	转为图片或重新编辑
批注/修订丢失	版本兼容性	检查保存格式是否为.docx

工作流程

Step 1: 诊断问题

如果用户提供了文件，运行诊断脚本：

pip install python-docx 2>/dev/null || pip3 install python-docx 2>/dev/null

from docx import Document
from docx.shared import Pt, Mm
from docx.oxml.ns import qn
import os

def diagnose_compat(file_path):
    """诊断文档兼容性问题"""
    doc = Document(file_path)
    issues = []

    # 检查字体
    risky_fonts = set()
    safe_fonts = {'宋体', '黑体', '楷体', '仿宋', '微软雅黑',
                  'Arial', 'Times New Roman', 'Calibri'}

    for para in doc.paragraphs:
        for run in para.runs:
            font_name = run.font.name
            east_asia = None
            rPr = run._element.find(qn('w:rPr'))
            if rPr is not None:
                rFonts = rPr.find(qn('w:rFonts'))
                if rFonts is not None:
                    east_asia = rFonts.get(qn('w:eastAsia'))

            for f in [font_name, east_asia]:
                if f and f not in safe_fonts:
                    risky_fonts.add(f)

    if risky_fonts:
        issues.append(f"⚠️ 发现 {len(risky_fonts)} 种非通用字体：{', '.join(risky_fonts)}")

    # 检查页面设置
    for section in doc.sections:
        if section.page_width != Mm(210) or section.page_height != Mm(297):
            issues.append("⚠️ 页面尺寸非标准A4")

    # 检查表格宽度
    for i, table in enumerate(doc.tables):
        issues.append(f"📊 表格{i+1}：{len(table.rows)}行 × {len(table.columns)}列")

    # 检查图片
    img_count = 0
    for para in doc.paragraphs:
        for run in para.runs:
            if run._element.findall(qn('w:drawing')):
                img_count += 1
    if img_count:
        issues.append(f"🖼️ 包含 {img_count} 张图片（可能有位移风险）")

    return issues