# DOCX Splitting

> 当需要在 Windows + Microsoft Word 环境中按页拆分 .docx 文件并尽量保留原始格式、图片、表格和分页效果时使用。

- Skill: `black-yt/docx-splitting` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add black-yt/docx-splitting`
- Raw SKILL.md: https://api.skillmd.com/api/skills/black-yt/docx-splitting/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: black-yt (https://skillmd.com/u/black-yt)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/black-yt/docx-splitting

---


# DOCX 按页拆分

## 使用场景

用于把一个 `.docx` 文档按页数拆分成多个较小的 `.docx` 文件，并尽量保留 Word 原始排版。

仅适用于 Windows + Microsoft Word 环境，因为脚本通过 `win32com.client` 调用 Word COM 自动化接口，分页结果依赖本机 Word 排版引擎。

## 依赖安装

前置条件：

- Windows。
- 已安装 Microsoft Word 桌面版。
- Python 与 Word 位数兼容，通常使用当前 Windows Python 即可。

```bash
pip install pywin32
```

安装后可做最小检查：

```bash
python -c "import win32com.client; print('pywin32 ok')"
```

## 脚本

优先使用 bundled script：

```text
scripts/split_docx.py
```

## 命令行用法

拆成 4 份：

```bash
python scripts/split_docx.py input.docx
```

拆成 8 份并指定输出目录：

```bash
python scripts/split_docx.py input.docx --output-dir split_output --parts 8
```

## Python 调用

```python
from scripts.split_docx import split_docx_lossless_by_pages

split_docx_lossless_by_pages(
    "input.docx",
    output_dir="split_output",
    parts=8,
)
```

## 注意事项

- 运行前关闭正在编辑的同一个 Word 文件。
- 建议先复制原始 `.docx`，在副本上运行。
- 字体缺失、页面设置差异或 Word 版本差异可能导致分页略有不同。
- `--parts` 必须是正整数；如果总页数少于 `parts`，脚本只会生成实际需要的 part。
- 如果拆分边界落在复杂表格、图片或分页符附近，需要人工检查边界页是否缺失或重复。

## 验证

拆分后人工打开输出文件，检查：

- 每个 part 是否能正常打开。
- 页码范围是否大致符合预期。
- 表格、图片、公式和标题格式是否保留。
- 相邻 part 之间是否有明显内容缺失或重复。