# WordToPDF

**Repository Path**: laoknas/word-to-pdf

## Basic Information

- **Project Name**: WordToPDF
- **Description**: 一个简单易用的Word文档转PDF工具，支持Microsoft Office Word和WPS Word。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-29
- **Last Updated**: 2025-12-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Word转PDF转换工具

一个简单易用的Word文档转PDF工具，支持Microsoft Office Word和WPS Word。

## 功能特性

- 支持单个Word文件转换
- 支持批量转换整个目录
- 支持递归处理子目录
- 支持自定义输出目录
- 兼容Microsoft Word和WPS Word
- 详细的转换进度和错误报告
- 转换统计信息（成功/失败数量、耗时）

## 系统要求

- Windows操作系统
- Python 3.6 或更高版本
- Microsoft Office Word 或 WPS Office Word

## 安装

1. 克隆或下载本项目到本地

2. 安装依赖包：

```bash
pip install -r requirements.txt
```

## 使用方法

### 方式一：使用Python脚本

#### 转换单个文件

```bash
python wordTopdf.py document.docx
```

指定输出路径：

```bash
python wordTopdf.py document.docx output.pdf
```

#### 转换整个目录

```bash
python wordTopdf.py -d ./documents
```

递归处理子目录：

```bash
python wordTopdf.py -d ./documents -r
```

指定输出目录：

```bash
python wordTopdf.py -d ./documents -r -o ./pdf_output
```

### 方式二：使用可执行文件

如果您已经打包了可执行文件，可以直接使用：

```bash
wordTopdf.exe document.docx
```

或

```bash
wordTopdf.exe -d ./documents -r
```

## 参数说明

| 参数 | 说明 |
|------|------|
| `-d, --directory` | 指定目录模式 |
| `-r, --recursive` | 递归处理子目录 |
| `-o, --output` | 指定输出目录 |

## 支持的文件格式

- `.docx` - Word文档
- `.doc` - 旧版Word文档

## 项目文件说明

| 文件 | 说明 |
|------|------|
| `wordTopdf.py` | 主程序，使用docx2pdf库，针对WPS Word优化 |
| `wordTopdf_universal.py` | 通用版本，支持MS Word和WPS Word，批量转换效率更高 |
| `wordTopdf_libreoffice.py` | 使用LibreOffice的转换版本 |
| `requirements.txt` | Python依赖包列表 |
| `wordTopdf.spec` | PyInstaller打包配置文件 |
| `version_info.txt` | 可执行文件版本信息 |

## 打包成可执行文件

使用PyInstaller打包：

```bash
pip install pyinstaller
pyinstaller wordTopdf.spec
```

打包后的可执行文件位于 `dist` 目录。

## 常见问题

### 1. 转换时出现"远程过程调用失败"错误

这是WPS Word的兼容性问题，但转换可能已经成功。程序会检查PDF文件是否生成，如果已生成则认为转换成功。

### 2. 提示"无法连接到Word应用程序"

请确保已安装Microsoft Office Word或WPS Office Word，并且可以正常运行。

### 3. 转换速度较慢

这是正常现象，因为每次转换都需要启动Word应用程序。批量转换大量文件时，建议使用 `wordTopdf_universal.py`，它只启动一次Word，效率更高。

### 4. PDF文件乱码

请确保Word文档中的字体在系统中已安装，或者将字体嵌入到Word文档中。

## 技术细节

### wordTopdf.py

- 使用 `docx2pdf` 库进行转换
- 自动处理Word应用程序的生命周期
- 针对WPS Word的兼容性问题进行了优化
- 适合简单转换和少量文件

### wordTopdf_universal.py

- 使用 `win32com.client` 通过COM接口与Word交互
- 智能选择Microsoft Word或WPS Word
- 手动管理Word应用程序，批量转换效率更高
- 适合大量文件转换

## 版本信息

- 版本：1.0.0
- 作者：WordToPDF工具
- 版权：Copyright © 2025

## 许可证

本项目仅供学习和个人使用。

## 更新日志

### v1.0.0 (2025-12-29)

- 初始版本发布
- 支持单个文件和批量转换
- 支持递归处理子目录
- 兼容Microsoft Word和WPS Word
- 优化WPS Word错误处理