简介本资源是一份面向普通QQ用户及家长群体的实用工具指南解决忘记密码后无法查看本地聊天记录的紧急需求尤其适用于需监护孩子网络行为或恢复误删对话的场景。文档为单个180KB的Word文件.docx系统讲解一款绿色免安装小软件的完整使用流程涵盖免密登录、聊天文字与图片分栏查看、记录导出为文本、打印存档等核心功能并重点说明密码修改、路径定位、实时监控开关等关键设置步骤。内容预览显示文档结构清晰含软件速览、功能实战、界面图示指引及合法使用提醒操作全程“傻瓜化”适配零基础用户快速上手。已有403人学习下载读者可直接获取可执行的落地方案、规避隐私风险的合规提示以及针对网吧登录、删除后恢复等特殊情形的实操应对策略。1. 本地QQ聊天记录不是文档.docx文件名是典型误判很多人在电脑里翻出一个叫“查看本地QQ聊天记录.docx”的文件下意识点开——结果提示“文件已损坏”或直接空白。这不是QQ出了bug而是根本性认知偏差QQ官方从不以Word文档格式存储聊天记录。它的本地数据实际保存在加密的SQLite数据库Msg2.db、Msg3.db和二进制缓存文件中路径通常位于C:\Users\{用户名}\Documents\Tencent Files\{QQ号}\Msg\下。.docx后缀大概率是用户手动重命名、导出工具生成的中间文件或是第三方脚本错误封装的结果。这类文件若未经正确解析直接双击打开只会看到乱码或报错。本文面向IT从业者及技术型用户聚焦真实可验证的本地数据提取路径不依赖任何非官方客户端、不调用未公开API、不破解加密逻辑而是基于QQ桌面版v9.9默认启用的明文消息缓存机制用标准SQL查询Python轻量解析在Windows系统上完成可复现、可审计、可批量处理的聊天记录还原。重点解决四类高频问题如何定位真实数据文件、怎样确认消息是否被加密、用什么命令快速查某天的全部对话、以及导出为结构化CSV时字段映射的坑。2. 定位真实数据源从QQ安装路径到Msg目录的三层校验法QQ聊天记录的物理存储位置并非固定不变它受QQ版本、登录方式扫码/密码、是否开启“漫游消息”等策略影响。盲目搜索*.db文件极易命中旧备份或无效快照。必须执行三层校验路径合法性、文件活跃性、内容可读性。2.1 第一层确认QQ主程序路径与用户数据根目录QQ桌面版默认安装路径为C:\Program Files (x86)\Tencent\QQ\但数据目录由注册表动态指向。需优先读取注册表键值而非硬编码路径reg query HKEY_CURRENT_USER\Software\Tencent\QQ\Accounts /s该命令会列出所有已登录QQ号及其对应的数据根路径例如输出中含HKEY_CURRENT_USER\Software\Tencent\QQ\Accounts\123456789\DataPath REG_SZ C:\Users\Alice\Documents\Tencent Files\123456789\提示DataPath值才是真实用户数据根目录Documents\Tencent Files\{QQ号}是常见路径但企业版或便携版可能指向AppData\Roaming\Tencent\QQ\。跳过注册表直接进Documents目录查找可能遗漏多账号场景下的主数据。2.2 第二层进入Msg子目录并筛选活跃数据库文件进入DataPath\Msg\目录后常见文件包括Msg2.db、Msg3.db、MsgEx.db及按日期命名的Msg_20240501.db等。关键判断依据是文件修改时间mtime与最近聊天时间是否匹配# PowerShell命令列出Msg目录下近7天内修改过的.db文件并显示大小 Get-ChildItem C:\Users\Alice\Documents\Tencent Files\123456789\Msg\*.db | Where-Object { $_.LastWriteTime -gt (Get-Date).AddDays(-7) } | Sort-Object LastWriteTime -Descending | Select-Object Name, Length, LastWriteTime输出示例Name Length LastWriteTime ---- ------ ------------- Msg3.db 12451840 2024/05/15 14:22:33 Msg_20240515.db 8923120 2024/05/15 10:08:17注意Msg3.db是QQ v9.7默认主库存储近30天高频消息Msg_20240515.db是按日分片库仅当用户开启“按日分库”选项时生成。若两者mtime均早于昨日则说明当前聊天未落盘——需检查QQ设置中“消息漫游”是否关闭关闭后消息仅存本地内存退出即丢。2.3 第三层用SQLite命令行验证数据库结构与基础可读性即使文件存在且新鲜也需确认其是否为有效SQLite库且含消息表。使用轻量级sqlite3.exe无需安装 官网下载单文件版 执行元数据探测# 进入Msg目录后执行 sqlite3 Msg3.db .tables正常输出应包含ChatMsg、Contact、GroupInfo等核心表名。若返回空或报错Error: file is encrypted or is not a database则该库启用了QQ的AES-128加密常见于开启“消息加密存储”的账号。此时需跳过此文件转向未加密的分片库如Msg_20240515.db或通过QQ设置临时关闭加密设置 → 隐私 → 消息加密存储 → 关闭 → 重启QQ。校验层级关键命令/操作成功标志失败应对路径合法性reg query HKEY_CURRENT_USER\Software\Tencent\QQ\Accounts /s输出含DataPath且路径可访问检查QQ是否以当前Windows用户运行或尝试HKEY_LOCAL_MACHINE路径文件活跃性Get-ChildItem *.db | Where-Object { $_.LastWriteTime -gt (Get-Date).AddDays(-1) }至少1个.db文件mtime在1天内检查QQ是否处于登录状态且未最小化到托盘部分版本后台不写盘内容可读性sqlite3 Msg3.db .tables输出含ChatMsg表启用“消息加密存储”导致加密需关闭后重启QQ再试3. 解析ChatMsg表字段含义、时间戳转换与联系人ID反查ChatMsg表是QQ本地消息的核心载体但其字段命名高度抽象如MsgId、MsgType、CreateTime且时间戳为Unix毫秒级整数联系人信息仅存ID。直接SELECT * FROM ChatMsg会得到一堆数字必须结合上下文映射才有业务意义。3.1 ChatMsg核心字段语义与典型值范围执行以下SQL获取前5条消息的原始结构SELECT MsgId, FromUin, ToUin, MsgType, SubMsgType, CreateTime, Content FROM ChatMsg LIMIT 5;关键字段解析如下基于QQ v9.9.13实测字段名类型含义说明典型值示例注意事项FromUinINTEGER发送方QQ号UIN123456789群消息中为群号私聊中为对方QQ号ToUinINTEGER接收方QQ号UIN987654321私聊中为自己的QQ号群消息中为群号与FromUin相同MsgTypeINTEGER消息大类类型1文本、2图片、3语音1000为系统消息如“你撤回了一条消息”SubMsgTypeINTEGER子类型标识0普通文本、1引用回复文本消息此字段常为0图片消息为100CreateTimeINTEGER消息创建时间毫秒级Unix时间戳1715762553123需转换为可读时间见3.2节ContentTEXT消息正文文本或序列化描述非文本你好或[图片]图片/文件消息此处为占位符真实路径需查PicInfo表提示MsgType2图片的Content字段值恒为[图片]真实文件路径不在本表而需关联PicInfo表PicInfo.PicMd5 ChatMsg.Content的MD5哈希值MsgType3语音同理需查VoiceInfo表。本文聚焦文本消息还原故暂不展开多媒体关联查询。3.2 将CreateTime毫秒时间戳转为标准日期时间CreateTime是13位毫秒级Unix时间戳如1715762553123直接datetime(CreateTime/1000, unixepoch)会因时区错误显示UTC时间。QQ本地库默认存储为本地时区时间戳需强制指定东八区-- 正确转换适配中国标准时间 SELECT datetime(CreateTime/1000, unixepoch, localtime) AS LocalTime, FromUin, ToUin, Content FROM ChatMsg WHERE MsgType 1 ORDER BY CreateTime DESC LIMIT 10;若使用Python脚本处理推荐用datetime.fromtimestamp(ts/1000)而非datetime.utcfromtimestamp()避免时区偏移。3.3 从UIN反查联系人昵称关联Contact表的必要性FromUin和ToUin仅为数字ID需关联Contact表获取真实昵称。Contact表结构关键字段Contact字段含义关联方式UinQQ号UINChatMsg.FromUin Contact.UinShowName显示名称好友备注或群昵称优先取此字段NickNameQQ昵称若无备注则 fallbackCOALESCE(Contact.ShowName, Contact.NickName)完整关联查询示例获取最近10条私聊文本消息的可读视图SELECT datetime(cm.CreateTime/1000, unixepoch, localtime) AS Time, COALESCE(c1.ShowName, c1.NickName) AS Sender, COALESCE(c2.ShowName, c2.NickName) AS Receiver, cm.Content FROM ChatMsg cm LEFT JOIN Contact c1 ON cm.FromUin c1.Uin LEFT JOIN Contact c2 ON cm.ToUin c2.Uin WHERE cm.MsgType 1 AND cm.FromUin ! cm.ToUin -- 排除自己发给自己的消息 ORDER BY cm.CreateTime DESC LIMIT 10;注意Contact表可能缺失部分历史联系人如已删除好友此时ShowName和NickName均为NULL需在应用层做空值处理如显示“未知用户(123456789)”。4. 批量导出为CSVPython脚本实现带过滤、去重、字段清洗的自动化流程手动执行SQL仅适合抽查生产环境需稳定导出为CSV供分析。以下Python脚本兼容Python 3.8完成三项核心任务自动发现最新Msg库、执行带条件的SQL查询、清洗Content字段中的QQ私有标记如c typeat uin123、按日期分文件导出。4.1 脚本核心逻辑与参数配置# qq_msg_export.py import sqlite3 import csv import os import re from datetime import datetime from pathlib import Path # 配置区按需修改 QQ_DATA_ROOT rC:\Users\Alice\Documents\Tencent Files\123456789 # 替换为你的DataPath OUTPUT_DIR rC:\QQ_Export # 导出CSV存放目录 DATE_FILTER 2024-05-01 # 只导出此日期之后的消息可为空字符串导出全部 MSG_TYPE_FILTER [1] # 只导出文本消息1添加3可导出语音2可导出图片占位符 # def clean_qq_content(text): 清洗QQ Content字段移除AT、表情、链接等私有标签 if not isinstance(text, str): return # 移除AT标签c typeat uin123昵称/c text re.sub(rc[^]*([^]*)/c, r[\1], text) # 移除表情标签em typeface id123/ text re.sub(rem[^]*, [表情], text) # 移除链接标签a href....../a text re.sub(ra[^]*([^]*)/a, r\1, text) # 清理多余空白 return re.sub(r\s, , text).strip() def find_latest_msg_db(msg_dir): 在Msg目录下找到mtime最新的.db文件 db_files list(Path(msg_dir).glob(*.db)) if not db_files: raise FileNotFoundError(未在Msg目录下找到任何.db文件) return max(db_files, keylambda x: x.stat().st_mtime) def export_to_csv(db_path, output_path): 执行SQL查询并导出CSV conn sqlite3.connect(db_path) cursor conn.cursor() # 构建动态WHERE条件 where_clauses [cm.MsgType IN ({}).format(,.join(map(str, MSG_TYPE_FILTER)))] if DATE_FILTER: where_clauses.append(datetime(cm.CreateTime/1000, unixepoch, localtime) {}.format(DATE_FILTER)) sql f SELECT datetime(cm.CreateTime/1000, unixepoch, localtime) AS Time, COALESCE(c1.ShowName, c1.NickName) AS Sender, COALESCE(c2.ShowName, c2.NickName) AS Receiver, cm.Content AS RawContent FROM ChatMsg cm LEFT JOIN Contact c1 ON cm.FromUin c1.Uin LEFT JOIN Contact c2 ON cm.ToUin c2.Uin WHERE { AND .join(where_clauses)} AND cm.FromUin ! cm.ToUin ORDER BY cm.CreateTime DESC cursor.execute(sql) rows cursor.fetchall() conn.close() # 写入CSV os.makedirs(OUTPUT_DIR, exist_okTrue) with open(output_path, w, newline, encodingutf-8-sig) as f: writer csv.writer(f) writer.writerow([Time, Sender, Receiver, Content]) # CSV头部 for row in rows: cleaned_content clean_qq_content(row[3]) writer.writerow([row[0], row[1] or 未知, row[2] or 未知, cleaned_content]) print(f✅ 已导出 {len(rows)} 条消息至 {output_path}) if __name__ __main__: msg_dir os.path.join(QQ_DATA_ROOT, Msg) if not os.path.exists(msg_dir): raise NotADirectoryError(fMsg目录不存在: {msg_dir}) latest_db find_latest_msg_db(msg_dir) timestamp datetime.now().strftime(%Y%m%d_%H%M%S) output_file os.path.join(OUTPUT_DIR, fQQ_Msg_{timestamp}.csv) export_to_csv(latest_db, output_file)4.2 执行与验证步骤安装依赖本脚本仅依赖Python标准库无需额外安装包。修改配置将QQ_DATA_ROOT替换为你通过注册表查到的真实路径。运行脚本python qq_msg_export.py验证输出打开生成的CSV检查Time列是否为本地时间如2024-05-15 14:22:33Sender/Receiver是否为有效昵称非NULLContent列中c typeat已被替换为[昵称]em被替换为[表情]。提示若导出内容为空首先检查DATE_FILTER是否设得过严其次用sqlite3命令行执行脚本中的SQL确认WHERE条件是否误筛了数据如MsgType值判断错误。5. 绕过加密库的应急方案利用QQ内置“导出聊天记录”功能生成HTML当Msg3.db等主库因开启“消息加密存储”而无法直接读取时最稳妥的替代方案是触发QQ客户端自身的导出功能。该功能生成的HTML文件虽非结构化数据但内容完全明文且保留时间、发送者、消息类型等关键信息可作为应急备份或人工核查依据。5.1 在QQ客户端中定位并执行导出操作登录目标QQ账号在聊天窗口中右键点击任意消息气泡 → 选择【更多】→【导出聊天记录】在弹出窗口中选择【导出为网页HTML】设置时间范围支持“全部”、“最近7天”、“自定义”指定保存路径如C:\QQ_HTML_Export\点击【导出】等待进度条完成。注意此功能仅对当前打开的聊天窗口生效。若需导出多个好友/群需逐个窗口操作。QQ v9.9 支持批量选择多个会话按住Ctrl点击会话列表但导出仍为单个HTML文件。5.2 解析HTML文件提取纯文本消息流生成的HTML文件如chat_123456789_20240515.html采用固定结构每条消息包裹在div classmsg-item中发送者姓名在span classsender-name时间在span classmsg-time内容在div classmsg-content。可用Python的BeautifulSoup进行轻量解析from bs4 import BeautifulSoup def parse_qq_html(html_path): with open(html_path, r, encodingutf-8) as f: soup BeautifulSoup(f, html.parser) messages [] for item in soup.find_all(div, class_msg-item): sender_elem item.find(span, class_sender-name) time_elem item.find(span, class_msg-time) content_elem item.find(div, class_msg-content) if sender_elem and time_elem and content_elem: # 清洗content移除br、img等标签保留纯文本 content_text content_elem.get_text(stripTrue) messages.append({ time: time_elem.get_text(stripTrue), sender: sender_elem.get_text(stripTrue), content: content_text }) return messages # 使用示例 msgs parse_qq_html(rC:\QQ_HTML_Export\chat_123456789_20240515.html) for m in msgs[:5]: print(f[{m[time]}] {m[sender]}: {m[content]})该方法优势在于零依赖加密密钥、不触碰数据库文件、符合QQ官方使用协议。缺点是无法批量自动化需GUI交互、HTML结构可能随QQ版本微调需定期验证CSS选择器。对于法务存证、临时取证等场景此方案比逆向解密更合规、更可靠。5.3 HTML导出与SQLite直读的适用边界对比场景推荐方案原因需要分析近30天全部消息且QQ未开启“消息加密存储”直接读取Msg3.db数据完整、字段丰富、支持SQL复杂查询如按关键词全文检索仅需导出某次重要对话用于邮件汇报QQ客户端HTML导出一键生成、带格式排版、无需编程、天然可信QQ已开启加密且无法临时关闭如企业管控策略HTML导出 BeautifulSoup解析绕过加密限制内容100%明文规避法律风险需要导出100个好友的聊天记录编写AutoHotKey脚本模拟GUI操作HTML导出SQLite方案在此规模下易因文件锁失败GUI自动化更稳定当看到“查看本地QQ聊天记录.docx”时请先删除这个误导性文件名——它不是入口而是路标失效的信号。真正的数据在Msg目录的SQLite库里而解锁它的钥匙是注册表路径、毫秒时间戳转换、Contact表关联以及对QQ自身导出功能的务实调用。本文还有配套的精品资源点击获取
QQ本地聊天记录解析：SQLite数据库提取与CSV导出实战
简介本资源是一份面向普通QQ用户及家长群体的实用工具指南解决忘记密码后无法查看本地聊天记录的紧急需求尤其适用于需监护孩子网络行为或恢复误删对话的场景。文档为单个180KB的Word文件.docx系统讲解一款绿色免安装小软件的完整使用流程涵盖免密登录、聊天文字与图片分栏查看、记录导出为文本、打印存档等核心功能并重点说明密码修改、路径定位、实时监控开关等关键设置步骤。内容预览显示文档结构清晰含软件速览、功能实战、界面图示指引及合法使用提醒操作全程“傻瓜化”适配零基础用户快速上手。已有403人学习下载读者可直接获取可执行的落地方案、规避隐私风险的合规提示以及针对网吧登录、删除后恢复等特殊情形的实操应对策略。1. 本地QQ聊天记录不是文档.docx文件名是典型误判很多人在电脑里翻出一个叫“查看本地QQ聊天记录.docx”的文件下意识点开——结果提示“文件已损坏”或直接空白。这不是QQ出了bug而是根本性认知偏差QQ官方从不以Word文档格式存储聊天记录。它的本地数据实际保存在加密的SQLite数据库Msg2.db、Msg3.db和二进制缓存文件中路径通常位于C:\Users\{用户名}\Documents\Tencent Files\{QQ号}\Msg\下。.docx后缀大概率是用户手动重命名、导出工具生成的中间文件或是第三方脚本错误封装的结果。这类文件若未经正确解析直接双击打开只会看到乱码或报错。本文面向IT从业者及技术型用户聚焦真实可验证的本地数据提取路径不依赖任何非官方客户端、不调用未公开API、不破解加密逻辑而是基于QQ桌面版v9.9默认启用的明文消息缓存机制用标准SQL查询Python轻量解析在Windows系统上完成可复现、可审计、可批量处理的聊天记录还原。重点解决四类高频问题如何定位真实数据文件、怎样确认消息是否被加密、用什么命令快速查某天的全部对话、以及导出为结构化CSV时字段映射的坑。2. 定位真实数据源从QQ安装路径到Msg目录的三层校验法QQ聊天记录的物理存储位置并非固定不变它受QQ版本、登录方式扫码/密码、是否开启“漫游消息”等策略影响。盲目搜索*.db文件极易命中旧备份或无效快照。必须执行三层校验路径合法性、文件活跃性、内容可读性。2.1 第一层确认QQ主程序路径与用户数据根目录QQ桌面版默认安装路径为C:\Program Files (x86)\Tencent\QQ\但数据目录由注册表动态指向。需优先读取注册表键值而非硬编码路径reg query HKEY_CURRENT_USER\Software\Tencent\QQ\Accounts /s该命令会列出所有已登录QQ号及其对应的数据根路径例如输出中含HKEY_CURRENT_USER\Software\Tencent\QQ\Accounts\123456789\DataPath REG_SZ C:\Users\Alice\Documents\Tencent Files\123456789\提示DataPath值才是真实用户数据根目录Documents\Tencent Files\{QQ号}是常见路径但企业版或便携版可能指向AppData\Roaming\Tencent\QQ\。跳过注册表直接进Documents目录查找可能遗漏多账号场景下的主数据。2.2 第二层进入Msg子目录并筛选活跃数据库文件进入DataPath\Msg\目录后常见文件包括Msg2.db、Msg3.db、MsgEx.db及按日期命名的Msg_20240501.db等。关键判断依据是文件修改时间mtime与最近聊天时间是否匹配# PowerShell命令列出Msg目录下近7天内修改过的.db文件并显示大小 Get-ChildItem C:\Users\Alice\Documents\Tencent Files\123456789\Msg\*.db | Where-Object { $_.LastWriteTime -gt (Get-Date).AddDays(-7) } | Sort-Object LastWriteTime -Descending | Select-Object Name, Length, LastWriteTime输出示例Name Length LastWriteTime ---- ------ ------------- Msg3.db 12451840 2024/05/15 14:22:33 Msg_20240515.db 8923120 2024/05/15 10:08:17注意Msg3.db是QQ v9.7默认主库存储近30天高频消息Msg_20240515.db是按日分片库仅当用户开启“按日分库”选项时生成。若两者mtime均早于昨日则说明当前聊天未落盘——需检查QQ设置中“消息漫游”是否关闭关闭后消息仅存本地内存退出即丢。2.3 第三层用SQLite命令行验证数据库结构与基础可读性即使文件存在且新鲜也需确认其是否为有效SQLite库且含消息表。使用轻量级sqlite3.exe无需安装 官网下载单文件版 执行元数据探测# 进入Msg目录后执行 sqlite3 Msg3.db .tables正常输出应包含ChatMsg、Contact、GroupInfo等核心表名。若返回空或报错Error: file is encrypted or is not a database则该库启用了QQ的AES-128加密常见于开启“消息加密存储”的账号。此时需跳过此文件转向未加密的分片库如Msg_20240515.db或通过QQ设置临时关闭加密设置 → 隐私 → 消息加密存储 → 关闭 → 重启QQ。校验层级关键命令/操作成功标志失败应对路径合法性reg query HKEY_CURRENT_USER\Software\Tencent\QQ\Accounts /s输出含DataPath且路径可访问检查QQ是否以当前Windows用户运行或尝试HKEY_LOCAL_MACHINE路径文件活跃性Get-ChildItem *.db | Where-Object { $_.LastWriteTime -gt (Get-Date).AddDays(-1) }至少1个.db文件mtime在1天内检查QQ是否处于登录状态且未最小化到托盘部分版本后台不写盘内容可读性sqlite3 Msg3.db .tables输出含ChatMsg表启用“消息加密存储”导致加密需关闭后重启QQ再试3. 解析ChatMsg表字段含义、时间戳转换与联系人ID反查ChatMsg表是QQ本地消息的核心载体但其字段命名高度抽象如MsgId、MsgType、CreateTime且时间戳为Unix毫秒级整数联系人信息仅存ID。直接SELECT * FROM ChatMsg会得到一堆数字必须结合上下文映射才有业务意义。3.1 ChatMsg核心字段语义与典型值范围执行以下SQL获取前5条消息的原始结构SELECT MsgId, FromUin, ToUin, MsgType, SubMsgType, CreateTime, Content FROM ChatMsg LIMIT 5;关键字段解析如下基于QQ v9.9.13实测字段名类型含义说明典型值示例注意事项FromUinINTEGER发送方QQ号UIN123456789群消息中为群号私聊中为对方QQ号ToUinINTEGER接收方QQ号UIN987654321私聊中为自己的QQ号群消息中为群号与FromUin相同MsgTypeINTEGER消息大类类型1文本、2图片、3语音1000为系统消息如“你撤回了一条消息”SubMsgTypeINTEGER子类型标识0普通文本、1引用回复文本消息此字段常为0图片消息为100CreateTimeINTEGER消息创建时间毫秒级Unix时间戳1715762553123需转换为可读时间见3.2节ContentTEXT消息正文文本或序列化描述非文本你好或[图片]图片/文件消息此处为占位符真实路径需查PicInfo表提示MsgType2图片的Content字段值恒为[图片]真实文件路径不在本表而需关联PicInfo表PicInfo.PicMd5 ChatMsg.Content的MD5哈希值MsgType3语音同理需查VoiceInfo表。本文聚焦文本消息还原故暂不展开多媒体关联查询。3.2 将CreateTime毫秒时间戳转为标准日期时间CreateTime是13位毫秒级Unix时间戳如1715762553123直接datetime(CreateTime/1000, unixepoch)会因时区错误显示UTC时间。QQ本地库默认存储为本地时区时间戳需强制指定东八区-- 正确转换适配中国标准时间 SELECT datetime(CreateTime/1000, unixepoch, localtime) AS LocalTime, FromUin, ToUin, Content FROM ChatMsg WHERE MsgType 1 ORDER BY CreateTime DESC LIMIT 10;若使用Python脚本处理推荐用datetime.fromtimestamp(ts/1000)而非datetime.utcfromtimestamp()避免时区偏移。3.3 从UIN反查联系人昵称关联Contact表的必要性FromUin和ToUin仅为数字ID需关联Contact表获取真实昵称。Contact表结构关键字段Contact字段含义关联方式UinQQ号UINChatMsg.FromUin Contact.UinShowName显示名称好友备注或群昵称优先取此字段NickNameQQ昵称若无备注则 fallbackCOALESCE(Contact.ShowName, Contact.NickName)完整关联查询示例获取最近10条私聊文本消息的可读视图SELECT datetime(cm.CreateTime/1000, unixepoch, localtime) AS Time, COALESCE(c1.ShowName, c1.NickName) AS Sender, COALESCE(c2.ShowName, c2.NickName) AS Receiver, cm.Content FROM ChatMsg cm LEFT JOIN Contact c1 ON cm.FromUin c1.Uin LEFT JOIN Contact c2 ON cm.ToUin c2.Uin WHERE cm.MsgType 1 AND cm.FromUin ! cm.ToUin -- 排除自己发给自己的消息 ORDER BY cm.CreateTime DESC LIMIT 10;注意Contact表可能缺失部分历史联系人如已删除好友此时ShowName和NickName均为NULL需在应用层做空值处理如显示“未知用户(123456789)”。4. 批量导出为CSVPython脚本实现带过滤、去重、字段清洗的自动化流程手动执行SQL仅适合抽查生产环境需稳定导出为CSV供分析。以下Python脚本兼容Python 3.8完成三项核心任务自动发现最新Msg库、执行带条件的SQL查询、清洗Content字段中的QQ私有标记如c typeat uin123、按日期分文件导出。4.1 脚本核心逻辑与参数配置# qq_msg_export.py import sqlite3 import csv import os import re from datetime import datetime from pathlib import Path # 配置区按需修改 QQ_DATA_ROOT rC:\Users\Alice\Documents\Tencent Files\123456789 # 替换为你的DataPath OUTPUT_DIR rC:\QQ_Export # 导出CSV存放目录 DATE_FILTER 2024-05-01 # 只导出此日期之后的消息可为空字符串导出全部 MSG_TYPE_FILTER [1] # 只导出文本消息1添加3可导出语音2可导出图片占位符 # def clean_qq_content(text): 清洗QQ Content字段移除AT、表情、链接等私有标签 if not isinstance(text, str): return # 移除AT标签c typeat uin123昵称/c text re.sub(rc[^]*([^]*)/c, r[\1], text) # 移除表情标签em typeface id123/ text re.sub(rem[^]*, [表情], text) # 移除链接标签a href....../a text re.sub(ra[^]*([^]*)/a, r\1, text) # 清理多余空白 return re.sub(r\s, , text).strip() def find_latest_msg_db(msg_dir): 在Msg目录下找到mtime最新的.db文件 db_files list(Path(msg_dir).glob(*.db)) if not db_files: raise FileNotFoundError(未在Msg目录下找到任何.db文件) return max(db_files, keylambda x: x.stat().st_mtime) def export_to_csv(db_path, output_path): 执行SQL查询并导出CSV conn sqlite3.connect(db_path) cursor conn.cursor() # 构建动态WHERE条件 where_clauses [cm.MsgType IN ({}).format(,.join(map(str, MSG_TYPE_FILTER)))] if DATE_FILTER: where_clauses.append(datetime(cm.CreateTime/1000, unixepoch, localtime) {}.format(DATE_FILTER)) sql f SELECT datetime(cm.CreateTime/1000, unixepoch, localtime) AS Time, COALESCE(c1.ShowName, c1.NickName) AS Sender, COALESCE(c2.ShowName, c2.NickName) AS Receiver, cm.Content AS RawContent FROM ChatMsg cm LEFT JOIN Contact c1 ON cm.FromUin c1.Uin LEFT JOIN Contact c2 ON cm.ToUin c2.Uin WHERE { AND .join(where_clauses)} AND cm.FromUin ! cm.ToUin ORDER BY cm.CreateTime DESC cursor.execute(sql) rows cursor.fetchall() conn.close() # 写入CSV os.makedirs(OUTPUT_DIR, exist_okTrue) with open(output_path, w, newline, encodingutf-8-sig) as f: writer csv.writer(f) writer.writerow([Time, Sender, Receiver, Content]) # CSV头部 for row in rows: cleaned_content clean_qq_content(row[3]) writer.writerow([row[0], row[1] or 未知, row[2] or 未知, cleaned_content]) print(f✅ 已导出 {len(rows)} 条消息至 {output_path}) if __name__ __main__: msg_dir os.path.join(QQ_DATA_ROOT, Msg) if not os.path.exists(msg_dir): raise NotADirectoryError(fMsg目录不存在: {msg_dir}) latest_db find_latest_msg_db(msg_dir) timestamp datetime.now().strftime(%Y%m%d_%H%M%S) output_file os.path.join(OUTPUT_DIR, fQQ_Msg_{timestamp}.csv) export_to_csv(latest_db, output_file)4.2 执行与验证步骤安装依赖本脚本仅依赖Python标准库无需额外安装包。修改配置将QQ_DATA_ROOT替换为你通过注册表查到的真实路径。运行脚本python qq_msg_export.py验证输出打开生成的CSV检查Time列是否为本地时间如2024-05-15 14:22:33Sender/Receiver是否为有效昵称非NULLContent列中c typeat已被替换为[昵称]em被替换为[表情]。提示若导出内容为空首先检查DATE_FILTER是否设得过严其次用sqlite3命令行执行脚本中的SQL确认WHERE条件是否误筛了数据如MsgType值判断错误。5. 绕过加密库的应急方案利用QQ内置“导出聊天记录”功能生成HTML当Msg3.db等主库因开启“消息加密存储”而无法直接读取时最稳妥的替代方案是触发QQ客户端自身的导出功能。该功能生成的HTML文件虽非结构化数据但内容完全明文且保留时间、发送者、消息类型等关键信息可作为应急备份或人工核查依据。5.1 在QQ客户端中定位并执行导出操作登录目标QQ账号在聊天窗口中右键点击任意消息气泡 → 选择【更多】→【导出聊天记录】在弹出窗口中选择【导出为网页HTML】设置时间范围支持“全部”、“最近7天”、“自定义”指定保存路径如C:\QQ_HTML_Export\点击【导出】等待进度条完成。注意此功能仅对当前打开的聊天窗口生效。若需导出多个好友/群需逐个窗口操作。QQ v9.9 支持批量选择多个会话按住Ctrl点击会话列表但导出仍为单个HTML文件。5.2 解析HTML文件提取纯文本消息流生成的HTML文件如chat_123456789_20240515.html采用固定结构每条消息包裹在div classmsg-item中发送者姓名在span classsender-name时间在span classmsg-time内容在div classmsg-content。可用Python的BeautifulSoup进行轻量解析from bs4 import BeautifulSoup def parse_qq_html(html_path): with open(html_path, r, encodingutf-8) as f: soup BeautifulSoup(f, html.parser) messages [] for item in soup.find_all(div, class_msg-item): sender_elem item.find(span, class_sender-name) time_elem item.find(span, class_msg-time) content_elem item.find(div, class_msg-content) if sender_elem and time_elem and content_elem: # 清洗content移除br、img等标签保留纯文本 content_text content_elem.get_text(stripTrue) messages.append({ time: time_elem.get_text(stripTrue), sender: sender_elem.get_text(stripTrue), content: content_text }) return messages # 使用示例 msgs parse_qq_html(rC:\QQ_HTML_Export\chat_123456789_20240515.html) for m in msgs[:5]: print(f[{m[time]}] {m[sender]}: {m[content]})该方法优势在于零依赖加密密钥、不触碰数据库文件、符合QQ官方使用协议。缺点是无法批量自动化需GUI交互、HTML结构可能随QQ版本微调需定期验证CSS选择器。对于法务存证、临时取证等场景此方案比逆向解密更合规、更可靠。5.3 HTML导出与SQLite直读的适用边界对比场景推荐方案原因需要分析近30天全部消息且QQ未开启“消息加密存储”直接读取Msg3.db数据完整、字段丰富、支持SQL复杂查询如按关键词全文检索仅需导出某次重要对话用于邮件汇报QQ客户端HTML导出一键生成、带格式排版、无需编程、天然可信QQ已开启加密且无法临时关闭如企业管控策略HTML导出 BeautifulSoup解析绕过加密限制内容100%明文规避法律风险需要导出100个好友的聊天记录编写AutoHotKey脚本模拟GUI操作HTML导出SQLite方案在此规模下易因文件锁失败GUI自动化更稳定当看到“查看本地QQ聊天记录.docx”时请先删除这个误导性文件名——它不是入口而是路标失效的信号。真正的数据在Msg目录的SQLite库里而解锁它的钥匙是注册表路径、毫秒时间戳转换、Contact表关联以及对QQ自身导出功能的务实调用。本文还有配套的精品资源点击获取
