简介这是一款面向Python初学者及短视频创作者的微信聊天界面生成工具基于PIL、OpenCV与moviepy实现自动化流程解析聊天文本数据、绘制对话气泡与时间标签、添加背景及阴影效果最终将图片序列合成为流畅视频可用于制作趣味段子视频、创意营销素材或教学演示场景。压缩包共23个文件包含3个py源码、16个png背景与素材、2个otf字体文件及txt输入示例包体约9.01MB目录结构清晰适合直接运行与二次修改。目前已有529人学习下载具备一定参考热度。读者可获得完整可运行的Python脚本、模拟微信界面的背景图与字体资源以及输入数据格式说明快速理解从数据到图片再到视频的完整生成链路还可在此基础上自定义头像、气泡样式、配色与文案扩展出个人定制版聊天视频生成器提升自动化处理与多媒体创作能力。 如果你刷短视频时见过那种用微信聊天记录做成的段子或者做 UI 演示时需要几张聊天界面截图那你很可能会需要这个项目Python 微信聊天界面生成器。网上类似工具大多是网页版打开网页截图样式改起来麻烦我自己用 Python 重新实现了一个改编版界面完全在本地用 PyQt5 绘制消息数据通过 JSON 驱动支持随机对话、手动编辑和一键导出长图。这篇文章把整个项目从选型、建模到踩坑的完整过程写出来尤其适合刚学 Python、想拿小项目练手的朋友。1. 为什么做这个“改编版”——需求场景与项目定位1.1 真实需求从哪来先说触发点。有段时间我在做产品演示材料需要一批聊天场景截图有用户咨询的、有订单确认的、有客服回访的。总不能拿真微信让同事配合聊一遍再截图效率低而且聊天内容完全不可控。更麻烦的是真微信截图里会出现真实头像、真实昵称直接用会有隐私问题。我需要的是一个能“批量造界面”的工具输入几段话就能生成一张和微信风格接近的聊天截图纯本地运行不碰任何真实账号数据。1.2 改编版到底“改编”了什么网上能搜到的聊天界面生成器很多是用 HTMLCSS 写的单页工具打开浏览器输入内容、截图步骤繁琐有些还需要联网加载资源。我这个改编版核心变化有三点一是从浏览器搬到了 Python 桌面端适合在本地批量处理二是把聊天内容改成数据驱动界面和内容彻底分离可以导入 JSON 批量出图三是在原版手动输入的基础上增加了随机对话生成配合模板能快速造出几十张不同场景的测试图。整个项目也顺带练了 PyQt5 的布局、事件、剪贴板、图像导出这些基本功。1.3 适用人群和必须守住的边界这个项目适合三类人想学 PyQt5 或 tkinter 的 Python 初学者需要一个带完整界面和交互的小项目做 UI 原型或产品演示的开发者需要快速产出聊天界面素材写自动化测试的测试工程师需要构造界面数据做视觉回归对比。但必须把边界说清楚它是“界面生成器”不是“造假工具”。不能拿生成出来的聊天截图去伪造聊天记录、编造事实、冒充身份更不能用于任何诈骗和造谣场景。这类用途不仅违背工具初衷还可能涉及违法。我自己的使用原则很朴素所有生成图片只用于本地学习、内部演示、测试用例和加了明确水印的公开素材需要公开使用时会再叠加“演示虚拟内容”的标识。2. 技术选型与工程初始化PyQt5、tkinter 还是 CustomTkinter2.1 三个主流方案对比动手之前先选框架我在这里纠结过一段时间。市面上 Python 做桌面界面基本就三个方向标准库 tkinter、Qt 的 Python 绑定 PyQt5/PySide6、以及基于 tkinter 二次封装的 CustomTkinter。直接给一张对比表省得大家自己试。对比维度tkinterPyQt5CustomTkinter上手难度低适合入门中高概念多低样式现成控件丰富度基础控件齐全非常丰富中等美观控件多圆角气泡/复杂样式需要 Canvas 自己画麻烦QSS 样式表直接支持支持部分圆角中文与字体渲染依赖系统字体偶尔发虚设置字体名后很清晰跟随 tkinter打包体积最小较大但可接受中等跨平台Windows/Linux/macOSWindows/Linux/macOSWindows/Linux/macOS单看表格好像 tkinter 更省事但它实现聊天界面里最核心的圆角气泡很别扭得用 Canvas 绘制背景色、边框、圆角半径都要手动算后期维护成本高。CustomTkinter 界面确实好看但可用控件数量还是少做长图导出时控制粒度不够。2.2 为什么最后选了 PyQt5我最后用 PyQt5核心原因是 QSS 样式表。聊天界面最像微信的部分是左右气泡、绿色背景、灰色头像框这些用 QSS 一段段声明就行不需要重写绘制逻辑。PyQt5 的 QListWidget 天然支持 item 级别的自定义控件每条消息可以塞进一个自己拼好的 QWidget头像、昵称、文本、时间都能自由布局。另一个原因是图像导出方便QWidget.grab() 一行就能把整个控件内容保存成图片tkinter 里做这种事要折腾 PostScript 或第三方库远没有 Qt 顺手。有一点要说明Qt 本身有 PySide6API 和 PyQt5 高度一致License 更宽松。我这里选 PyQt5 是因为老项目沉淀的代码都是 PyQt5如果你是新开项目用 PySide6 完全没问题项目代码几乎不用改。重点不是用哪个而是明白界面和数据结构要分离。2.3 环境准备从 Python 安装到 VSCode 配置不管你是 Windows、macOS 还是 Linux先把 Python 装好。Windows 用户去官网下载安装包时第一屏记得勾选 Add Python to PATH这一步能省掉后面一堆命令行报错。VSCode 里装好 Python 和 Pylance 插件按 CtrlShiftP 选择解释器指向刚安装的 Python 即可。之后创建虚拟环境避免和系统 Python 装混python -m venv venv # Windows venv\Scripts\activate # Linux/macOS source venv/bin/activate然后安装依赖这个项目其实只要一个 PyQt5pip install PyQt5在 Ubuntu 24.04 这类 Linux 发行版上如果直接跑提示缺少 xcb 相关库后面第 5 节会讲怎么处理。先确认python -c import PyQt5不报错环境就算通了。3. 界面还原从顶部标题栏到消息气泡的完整实现3.1 整体界面结构一个能看的聊天界面至少包含三块顶部栏、消息列表、输入区。在我的实现里主窗口是 QMainWindow中间放一个 QWidget 做 central widget整个界面用 QVBoxLayout 从上到下排成三层。顶部栏高度固定左边放返回图标占位中间显示对方昵称和在线状态右侧放更多操作按钮的占位文字。消息列表用 QListWidget 撑起中间区域设置setVerticalScrollMode(QAbstractItemView.ScrollPerPixel)这样滚动更接近手机上的跟手效果。底部输入区用 QTextEdit 加一个发送按钮QTextEdit 而不是 QLineEdit因为消息内容可能多行回车发送时还要拦一下。窗口尺寸我固定成 420x760接近手机竖屏比例。别用 1920x1080 那种横屏比例直接做截出来的图一眼假谁也不会横着拿手机看微信。3.2 消息气泡与头像的实现方式每条消息我用一个 QListWidgetItem再通过setItemWidget塞进自定义消息控件。发消息的人和收消息的人通过不同布局方向区分自己发的消息头像放在右侧、气泡靠右收到消息头像在左侧、气泡靠左。核心逻辑是先创建一行的 QWidget设置水平布局然后判断 sender 字段是 self 还是 other决定是先加头像还是先加气泡。气泡本身是一个 QLabel背景色用 QSS 设置自己发的用#95EC69收到的用#FFFFFF文字颜色用#111111。圆角用border-radius: 8px;实现再加 6 像素的内边距。有一个细节是 QLabel 默认不会被内容撑开因为它的 sizePolicy 默认是 Preferred我在代码里显式设置了setMaximumWidth(260)否则文字会把气泡撑满整个窗口看起来完全不像聊天记录。3.3 输入区与发送交互输入区高度我设成 56 像素QTextEdit 不显示边框背景保持白色发送键用 QPushButton 包一层默认文字“发送”。发送逻辑分两步读输入框文本过滤纯空格内容然后把这条消息追加到列表里同时更新数据模型中的当前会话。追加之后必须调用listWidget.scrollToBottom()不然屏幕还停在旧位置体验很怪。回车发送通过重写 QTextEdit 的 keyPressEvent 实现按回车时如果同时按住 Shift 就插入换行否则触发发送。这段逻辑很常规但几乎每个第一次接触 Qt 事件的人都容易漏掉QTextEdit 默认回车就是换行不做拦截的话按一下回车消息没发出去界面倒是多了一行空行。3.4 界面风格的关键配置我不建议把聊天界面做成 1:1 复制微信容易引发版权和合规争议做到“信息层级像”就够了。顶部栏字体用 15pt 加粗消息时间用 11pt 灰色气泡内文字用 13pt。头像我用本地素材目录里的几张纯色头像图片不用任何真实人物照片。整体 QSS 简化后长这样QMainWindow { background: #ededed; } QListWidget { background: #ededed; border: none; } QTextEdit { border: none; background: white; border-radius: 6px; padding: 6px; } QPushButton#sendBtn { background: #07c160; color: white; border: none; border-radius: 6px; padding: 6px 16px; }把样式和逻辑分开后后续调颜色、调间距只改 QSS不需要动布局代码。4. 数据驱动逻辑消息结构、随机对话与长图导出4.1 消息数据模型界面只是壳真正让生成器好用的是消息数据模型。我把一条消息定义成一个字典包含四个字段sender 表示说话人取值为 self 或 otheravatar 表示头像文件名text 表示消息内容time 表示消息时间字符串。再多加一个 msg_type 字段用于特殊消息气泡比如系统提示、转账、文件等默认填 text。JSON 结构示例[ { sender: other, avatar: avatar_a.png, text: 你好我想咨询一下会员价格, time: 14:03 }, { sender: self, avatar: avatar_b.png, text: 你好会员分月卡和年卡你需要哪种, time: 14:04 } ]导入流程很简单从 JSON 文件读进来遍历 list每一项都传给界面渲染函数。文件路径、会话名称、头像目录这些在启动时通过配置文件读取不用每次启动都改代码。4.2 从 JSON 加载时的类型转换坑这段经验特别适合 Python 初学者。JSON 解析出来的所有值类型并不一定是你想要的。比如配置文件里写了fontSize: 13解析出来是 int没问题但写showTime: true解析出来是字符串true直接放进if showTime:判断永远为 True因为非空字符串就是真值。处理办法是统一做类型转换show_time config.get(showTime, false).lower() true font_size int(config.get(fontSize, 13))时间戳同理。如果 JSON 里时间字段是 2025-05-01 14:03:00想只显示 14:03用str.split( )[1][:5]切片或者datetime.strptime解析都比直接把字符串塞进界面更规范。数据层把类型洗干净了界面层就不用到处做防御性判断。4.3 随机对话生成随机生成不是乱生成我用的是“场景模板 槽位替换”的方式。先定义一批场景比如客服咨询、朋友约饭、快递通知每个场景包含一组消息模板模板里有槽位比如{time}、{name}、{item}。生成时随机选一个场景再从词库中随机填词。举个例子“快递通知”模板是templates [ (other, 你好{name}的快递已放到快递柜取件码是{code}), (self, 好的谢谢我下班去取), ] names [张女士, 李先生] codes [3-4502, 6-8821]生成时用 random.choice 换掉花括号里的内容然后逐条渲染到界面。实际用途是批量造测试数据给视觉回归测试提供 50 张不同名字、不同取件码的界面截图人工不可能快速造出来。模板内容都是虚拟场景不涉及真实个人信息。4.4 长图导出与批处理单张截图用系统截图工具就能做但聊天记录往往不止一屏长图导出才是刚需。PyQt5 里最省事的方案新建一个和窗口同样宽度的 QWidget把当前消息列表的所有 item 重新渲染进一个垂直布局等界面布局计算完成后再调用grab()保存图片。核心代码def export_long_image(self, pathchat.png): container QWidget() container.setFixedWidth(420) layout QVBoxLayout(container) layout.setSpacing(0) for i in range(self.list_widget.count()): item self.list_widget.item(i) widget self.list_widget.itemWidget(item) layout.addWidget(widget) container.adjustSize() pixmap container.grab() pixmap.save(path)注意adjustSize()必须放在grab()之前否则控件尺寸还是旧的导出的图会缺内容。导出后可以顺手用 QApplication.clipboard().setImage() 把图片复制到剪贴板方便直接粘贴到文档里省一步存文件的操作。5. 手把手避坑中文虚化模糊、气泡错位与 Ubuntu 24.04 适配5.1 中文显示虚化模糊的根因与修复这是整个项目里最磨人的问题。同样的代码在 Windows 上显示正常切到 Linux 或换了缩放比例后中文标题和按钮文字就明显发虚笔画边缘像蒙了一层雾。根因分两类一是 Qt 默认没有开启高 DPI 缩放Windows 系统缩放设为 125% 或 150% 时不设置缩放策略界面会走位文字渲染也发糊二是 Linux 上缺少中文字体或者 Qt 没选中字体fallback 到点阵字体后笔画就被强行像素化。修复分两步。第一步在创建 QApplication 之前设置from PyQt5.QtCore import Qt from PyQt5.QtWidgets import QApplication QApplication.setAttribute(Qt.AA_EnableHighDpiScaling, True) QApplication.setAttribute(Qt.AA_UseHighDpiPixmaps, True)第二步显式指定字体族不要在 QSS 里只写font-size不写字体名。Windows 上用Microsoft YaHeiLinux 上用Noto Sans CJK SCmacOS 用PingFang SC。启动时按平台判断import platform system platform.system() if system Windows: font_family Microsoft YaHei elif system Linux: font_family Noto Sans CJK SC else: font_family PingFang SC app.setFont(QFont(font_family, 10))在 Ubuntu 上如果发现没有 Noto Sans CJK直接sudo apt install fonts-noto-cjk装上就行。字体问题修好之后整个界面清晰度会有质的提升。5.2 气泡错位与文本换行的两个隐藏坑气泡错位大多数情况下不是架构问题是对齐策略没配置好。QListWidgetItem 默认的 textAlignment 是居左但如果你给 item 设置了自定义控件item 的 textAlignment 不影响控件位置影响的是 item 的高度计算。所以自定义控件做左右气泡时一定要在控件布局里用 addStretch() 占位自己发的消息头像后面加 stretch收到的消息气泡和头像之间放 stretch。文本换行也有两个坑。QLabel 默认不换行一条长文本会把气泡撑破必须setWordWrap(True)。另外只开换行还不够要限制气泡最大宽度否则换行遇到长英文单词时会直接把整个窗口撑开。除了setMaximumWidth(260)还要在 QSS 里给气泡 QLabel 加上word-wrap: break-word;对应的样式能力Qt 的 QSS 对 word-break 支持有限所以严格控制宽度反而更稳。高度计算同样容易踩自定义控件的 item 高度默认不会根据内容自适应需要在 item 创建时手动估算高度。我的做法是先QLabel.setText(msg)再label.adjustSize()然后根据 label 的高度加上上下内边距和头像高度最终用item.setSizeHint(QSize(420, estimated_height))设置。不设这个值长消息和短消息的 item 高度完全一样列表看起来非常奇怪。5.3 Ubuntu 24.04 下的依赖与运行在 Ubuntu 24.04 上跑 PyQt5Python 3.12 装 PyQt5 没问题但运行时会报这类错qt.qpa.plugin: Could not load the Qt platform plugin xcb原因是系统缺少 Qt 需要的 xcb 相关运行库。装两个依赖基本就解决sudo apt update sudo apt install libxcb-cursor0 libxkbcommon-x11-0有些干净环境还要装libxcb-icccm4、libxcb-keysyms1但 24.04 下最常见的就是 libxcb-cursor0。另外建议用虚拟环境跑项目不要图省事直接pip install --systemUbuntu 系统 Python 被系统包管理工具管着装坏了很麻烦。顺带说一句网上搜索时总能看到“微信 Linux 版”“微信数据目录”这些词作为聊天界面生成器的使用者要拎清边界这个工具和微信官方客户端没有任何关系不会去读微信数据目录也解析不了真聊记录。我只把数据放在工具自己的 config 和 output 目录下输入输出全部本地可控避免一切涉及个人隐私数据的操作。5.4 我的使用习惯和后续扩展方向项目跑通之后我现在主要把它当“素材管道”用写好 JSON 或模板批量生成一批图脚本自动存到 output 目录然后交给下游做 UI 走查或文档配图。如果你也想拿去扩展比较实用的方向有两个一是加一个简单的编辑界面在列表里双击消息直接改文字改完自动刷新气泡这样比改 JSON 直观二是接入 Tesseract 或其他 OCR做界面截图后自动识别文字位置再替换文本生成新图这样可以从一张真实布局推导出虚拟数据。第二个方向有点绕但做自动化演示素材非常省力。最后说个人经验这个项目最值钱的地方不是代码量而是让你把“界面”和“数据”分层的习惯养起来。第一次用 PyQt5 做东西很容易把所有逻辑塞进 Widget 里后面改需求会非常痛苦。从 JSON 导入内容、用 QSS 控制样式、把导出逻辑单独抽成函数这三件事改完项目结构就健康了一大半。再啰嗦一句边界生成聊天界面的工具本身是中性的学习、测试、演示都有价值但把它用于伪造记录、误导他人就是另一回事了。我始终只在明确标注虚拟演示的场合使用输出图片这既是对别人负责也是对自己负责。本文还有配套的精品资源点击获取