TXT2DOCX - 智能文本转Word文档工具

📖 项目简介

TXT2DOCX 是一个功能强大的文本转换工具，能够将纯文本（TXT）文件智能转换为格式化的 Word 文档（DOCX）。支持 Markdown 语法解析、错别字自动纠正、图片插入和专业样式排版。

✨ 核心特性

• 🎨 专业样式系统 - 内置8款精美样式模板，支持自定义样式编辑
• 📝 Markdown 支持 - 完整支持 Markdown 语法转换
• 🔧 智能文本处理 - 自动错别字纠正和文本优化
• 🖼️ 图片处理 - 智能图片插入和尺寸调整
• 📦 批量处理 - 支持多文件批量转换
• 🎯 所见即所得 - 高级样式编辑器实时预览功能
• 🖥️ 图形界面 - 友好的 GUI 界面，操作简单直观

🚀 快速开始

环境要求

• Python 3.7+
• Windows 10/11 (推荐) 或 Linux/macOS

依赖安装

pip install python-docx pillow tkinter

启动程序

python main.py

📁 项目结构

TxT2DOCX/
├── main.py                    # 主程序入口
├── config.py                  # 配置管理
├── style_manager.py           # 样式管理系统
├── advanced_style_editor.py   # 高级样式编辑器
├── file_handler.py           # 文件处理模块
├── text_processor.py         # 文本处理模块
├── markdown_parser.py        # Markdown 解析器
├── docx_generator.py         # DOCX 生成器
├── image_processor.py        # 图片处理模块
├── error_chars.py            # 错别字处理
├── batch_processor.py        # 批量处理器
├── gui_*.py                  # GUI 界面模块
├── data/                     # 数据目录
│   ├── styles/              # 样式文件
│   │   ├── *.json          # 自定义样式配置
│   │   └── ...
│   ├── error_chars.json     # 错别字映射表
│   └── 11.txt              # 测试文件
├── replacestr.py            # 文本替换工具
├── Txt2docx2.py            # 原版兼容脚本
└── README.md               # 说明文档

🎨 内置样式模板

新媒体风格

1. 爆款文章风格 - 高阅读量文章排版，层次分明
2. 微信公众号风格 - 专业新媒体排版，阅读体验佳
3. 知乎高赞回答风格 - 逻辑清晰，专业权威
4. 小红书笔记风格 - 清新文艺，生活方式类内容
5. 今日头条新闻风格 - 信息密度高，节奏紧凑
6. B站UP主视频脚本风格 - 轻松活泼，年轻化表达

商务风格

7. 企业微信群通知风格 - 正式严肃，商务专业
8. 情感鸡汤文风格 - 温暖治愈，情感丰富

🛠️ 功能模块详解

1. 样式管理系统

• 内置样式库 - 8款专业排版样式
• 自定义样式 - 支持创建、编辑、导入、导出
• 样式预览 - 实时预览样式效果
• 样式继承 - 基于现有样式快速定制

2. 高级样式编辑器

• 实时预览 - 丰富预览模式，所见即所得
• 分层编辑 - 基本信息、正文样式、标题样式分层管理
• 字体配置 - 字体、字号、颜色、粗体、斜体全支持
• 段落设置 - 行距、缩进、间距精确控制
• 标题层次 - 1-3级标题样式独立配置

3. 文本处理引擎

• 编码检测 - 自动识别文件编码（UTF-8, GBK, GB2312等）
• 错别字纠正 - 基于词典的智能错别字替换
• 文本清洗 - 去除多余空白和格式化字符
• 段落控制 - 控制每段最大句子数，自动分割过长段落
• Markdown解析 - 支持标题、列表、引用、代码块等

4. 图片处理功能

• 自动插入 - 识别文本中图片引用并自动插入
• 尺寸调整 - 智能调整图片尺寸适配文档
• 格式支持 - 支持 PNG, JPG, GIF 等常见格式

5. 批量处理器

• 多文件处理 - 同时处理多个TXT文件
• 进度跟踪 - 实时显示处理进度
• 错误处理 - 详细的错误报告和恢复机制

📖 使用教程

基础使用流程

1. 启动程序

   python main.py
   

2. 选择样式

   • 在样式管理选项卡中选择心仪的排版样式
   • 或者点击"高级编辑"自定义样式

3. 导入文件

   • 在文件处理选项卡中选择要转换的TXT文件
   • 支持单文件或批量文件选择

4. 配置选项

   • 设置输出路径
   • 配置文本处理选项
   • 调整图片处理参数

5. 开始转换

   • 点击"开始转换"按钮
   • 等待处理完成并查看结果

高级样式编辑

1. 打开编辑器

   • 选择基础样式 → 点击"高级编辑"
   • 或在样式管理中点击"新建"创建全新样式

2. 编辑样式

   • 基本信息: 修改样式名称和描述
   • 正文样式: 设置字体、字号、颜色、行距等
   • 标题样式: 分别配置1-3级标题的样式

3. 实时预览

   • 切换到"丰富预览"模式查看真实效果
   • 调整参数时预览会实时更新

4. 保存样式

   • 点击"保存样式"覆盖当前样式
   • 或点击"另存为"创建新样式

Markdown 语法支持

支持的 Markdown 语法：

# 一级标题
## 二级标题  
### 三级标题

**粗体文字**
*斜体文字*

> 引用块内容

- 无序列表项
- 无序列表项

1. 有序列表项
2. 有序列表项

`行内代码`

``代码块```

![图片](path/to/image.png)

⚙️ 配置说明

样式配置

样式配置文件位于 data/styles/ 目录，为 JSON 格式：

{
  "name": "自定义样式",
  "description": "样式描述",
  "body_font": {
    "name": "微软雅黑",
    "size": 14,
    "color": "#000000",
    "bold": false,
    "italic": false
  },
  "body_paragraph": {
    "line_spacing": 1.5,
    "first_line_indent": 2.0,
    "space_before": 0,
    "space_after": 6
  },
  "heading_styles": {
    "1": {
      "font": {
        "name": "黑体",
        "size": 18,
        "color": "#1F497D",
        "bold": true
      }
    }
  }
}

错别字配置

错别字映射表位于 data/error_chars.json：

{
  "错别字1": "正确字1",
  "错别字2": "正确字2"
}

🔧 开发指南

代码架构

• 模块化设计 - 功能模块独立，低耦合高内聚
• 配置驱动 - 通过配置文件管理样式和参数
• 事件驱动 - GUI 采用事件驱动模式
• 插件化 - 易于扩展新功能和样式

扩展开发

添加新样式

1. 在 style_manager.py 的 _create_builtin_styles() 中添加样式定义
2. 配置字体、段落、标题等样式参数
3. 重启程序即可使用新样式

添加新的文本处理功能

1. 在 text_processor.py 中添加处理函数
2. 在 batch_processor.py 中调用新功能
3. 可选：在 GUI 中添加相应配置选项

段落句子数控制

1. 在配置界面的"文字处理"选项卡中设置"每段最大句子数"
2. 设置为0表示不限制，大于0的数值表示每段最多包含的句子数
3. 程序会自动将超过限制的段落分割成多个段落

扩展图片处理

1. 在 image_processor.py 中添加新的处理方法
2. 支持新的图片格式或处理效果
3. 在 docx_generator.py 中集成新功能

🐛 常见问题

Q: 程序启动失败

A: 请检查 Python 版本（需要3.7+）和依赖包安装：

pip install python-docx pillow tkinter

Q: 中文乱码问题

A: 程序会自动检测文件编码，如仍有问题请确保TXT文件保存为UTF-8编码。

Q: 样式保存失败

A: 检查 data/styles/ 目录的写入权限，必要时以管理员身份运行程序。

Q: 图片无法插入

A: 确保图片路径正确，支持相对路径和绝对路径，图片格式为 PNG/JPG/GIF。

Q: 转换速度慢

A: 大文件处理需要时间，可通过批量处理提高效率。图片较多时会影响速度。

📝 更新日志

v2.0.0 (Latest)

• ✨ 新增高级样式编辑器，支持实时预览
• 🎨 重构样式系统，新增8款专业样式模板
• 🖥️ 优化GUI界面，提升用户体验
• 🔧 改进错误处理和异常恢复机制
• 📦 模块化重构，提高代码可维护性

v1.0.0

• 🎉 初始版本发布
• 📝 基础文本转换功能
• 🎨 简单样式支持
• 🖼️ 图片插入功能

🤝 贡献指南

欢迎贡献代码和建议！

1. Fork 本项目
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

开发规范

• 遵循 PEP 8 Python 代码规范
• 添加适当的注释和文档字符串
• 编写单元测试（推荐）
• 确保向后兼容性

📄 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件

👨‍💻 作者

• 项目维护者 - 负责项目开发和维护

🙏 致谢

• 感谢所有贡献者的支持
• 感谢开源社区提供的优秀库和工具
• 特别感谢用户反馈和建议

📞 联系方式

如有问题或建议，欢迎通过以下方式联系：

• 提交 Issue
• 邮件咨询
• 微信交流群

---

让文本转换变得简单而美好！ ✨