# Word模板替换工具使用文档

**Repository Path**: ycy2021/word_auto_write

## Basic Information

- **Project Name**: Word模板替换工具使用文档
- **Description**: 本工具专为批量生成标准化文档设计，支持以下核心功能：
- 📄 动态替换Word模板中的文本占位符，占位符格式为{zhanweifu}
- 🖼️ 自动插入指定路径的图片到对应的占位符，占位符格式同上
- ⚙️ 通过配置文件管理替换规则
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-30
- **Last Updated**: 2025-04-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: sop, 自动化文档

## README

# Word模板替换工具使用文档

---

## 目录
1. [工具概述](#工具概述)
2. [环境要求](#环境要求)
3. [快速入门](#快速入门)
4. [详细操作指南](#详细操作指南)  
   4.1 [配置文件说明](#配置文件说明)  
   4.2 [界面功能详解](#界面功能详解)  
   4.3 [图文替换操作](#图文替换操作)  
5. [常见问题](#常见问题)
6. [附录](#附录)

---

## 工具概述
本工具专为批量生成标准化文档设计，支持以下核心功能：
- 📄 动态替换Word模板中的文本占位符
- 🖼️ 自动插入指定路径的图片
- ⚙️ 通过配置文件管理替换规则
- 📦 一键生成文档及配置备份

适用场景：包装指引、合同模板、报告生成等标准化文档制作。

---

## 环境要求
### 最低配置
| 组件 | 要求 |
|------|------|
| 操作系统 | Windows 10 / macOS 10.15+ |
| Python | 3.8+ |
| 内存 | 4GB+ |
| 存储 | 100MB可用空间 |

### 依赖安装
```bash
pip install -r requirements.txt
```
> 需包含以下库：  
> `python-docx==0.8.11`  
> `Pillow==9.0.1`  
> `tkinter`

---

## 快速入门
### 第一步：准备文件
```
项目目录/
├── 模板.docx    # Word模板文件
├── config.json  # 配置文件
└── images/      # 图片素材目录
```

### 第二步：启动工具
```bash
python meigong_sop.py
```

### 第三步：基本操作流程
![操作流程图](https://via.placeholder.com/600x300?text=工具操作流程图)

---

## 详细操作指南
### 配置文件说明
#### 文本占位符配置
```json
{
    "text_placeholders": [
        {
            "name": "项目名称",
            "placeholder": "{project_name}",
            "default": "SED009"
        }
    ]
}
```

#### 图片占位符配置
```json
{
    "image_placeholders": [
        {
            "name": "产品示意图",
            "placeholder": "{product_img}",
            "default": "images/product.png"
        }
    ]
}
```

---

### 界面功能详解
![主界面示意图](https://via.placeholder.com/800x500?text=工具主界面标注说明)

1. **配置管理区**  
   - 配置文件路径：支持自定义JSON配置文件
   - 重新加载：动态更新配置

2. **模板操作区**  
   - 模板选择：支持.docx文件
   - 自动生成输出路径

3. **替换内容区**  
   - 文本替换：支持20个动态字段
   - 图片替换：支持15张图片插入

---

### 图文替换操作
#### 文本替换示例
1. 在模板中插入占位符：  
   `{project_name}`
2. 在工具界面输入实际值：  
   ![文本输入示例](https://via.placeholder.com/400x200?text=项目名称输入示例)

#### 图片替换示例
1. 模板中插入占位符：  
   `{product_img}`
2. 通过浏览按钮选择图片：  
   ![图片选择示例](https://via.placeholder.com/400x200?text=图片选择操作示意)

---

## 常见问题
### Q1：提示"配置文件未找到"
✅ 解决方案：  
1. 检查`config.json`是否在程序目录
2. 通过"浏览"按钮手动指定路径

### Q2：图片显示异常
✅ 排查步骤：  
1. 检查图片路径是否包含中文
2. 确认图片格式为JPG/PNG
3. BMP文件需转换为PNG格式

### Q3：生成文档乱码
✅ 处理方法：  
1. 确保模板文件使用UTF-8编码
2. 检查占位符格式是否正确

---

### 版本更新日志
| 版本 | 日期       | 更新内容                 |
|------|------------|--------------------------|
| 1.0  | 2024-04-30 | 初始发布版本             |

---