在Telegram的日常使用中，聊天记录可能包含重要的工作信息、珍贵的回忆或关键的业务沟通。将聊天记录导出为JSON（JavaScript Object Notation）格式，既便于程序化处理、数据分析，也能作为通用备份文件长期保存。本教程将介绍多种将Telegram聊天记录导出为JSON的方法，从简单的桌面版操作到可定制的API脚本，帮助您根据自身需求选择最合适的方案。
方法一：使用Telegram官方桌面版导出JSON
Telegram桌面版（Windows/macOS/Linux）内置了导出功能，可以直接输出JSON格式，适合不熟悉编程的用户。步骤如下：
- 打开Telegram桌面版并登录您的账号。
- 点击左上角的“汉堡菜单”（三条横线），选择“设置”。
- 在设置页面中，切换到“高级”选项卡。
- 在“导出聊天记录”区域，点击“导出数据”按钮。
- 在弹出的窗口中，可以选择导出范围（全部聊天、特定对话）以及包含的内容（消息、媒体、联系人等）。建议勾选“机器可读JSON”选项，以便生成JSON文件。
- 点击“导出”并选择保存位置，等待完成。
导出的JSON文件结构清晰，包含消息文本、发送者、时间戳等信息，可直接用于数据迁移或分析。
方法二：使用Telethon脚本导出JSON
如果您需要更灵活的控制，例如按日期筛选或自动处理多个对话，使用Telethon库编写Python脚本是理想选择。Telethon是第三方开的Telegram客户端库，安全且功能强大。
准备工作
- 安装Python 3.7及以上版本。
- 安装Telethon：
pip install telethon - 获取API ID和API Hash：登录 my.telegram.org，创建应用后获得。
导出单个对话的JSON
import asyncio
import json
from telethon import TelegramClient
api_id = 123456 # 替换为您的API ID
api_hash = 'your_api_hash'
client = TelegramClient('session', api_id, api_hash)
async def export_chat(entity, limit=1000):
await client.start()
messages = []
async for message in client.iter_messages(entity, limit=limit):
messages.append({
'id': message.id,
'date': message.date.isoformat(),
'sender_id': message.sender_id,
'text': message.text,
})
with open('chat_export.json', 'w', encoding='utf-8') as f:
json.dump(messages, f, ensure_ascii=False, indent=2)
asyncio.run(export_chat('username')) # 替换为聊天对象（用户名或ID）
该脚本会将最近的1000条消息导出为JSON文件。您可根据需要调整limit或通过date参数指定时间范围。
方法三：使用第三方工具tdl
如果您希望使用现成的命令行工具，tdl（Telegram Downloader）是一个高性能的跨平台解决方案，支持导出JSON格式。首先安装tdl：
- 从GitHub Releases下载对应系统的二进制文件，或使用
go install github.com/iyear/tdl@latest安装。 - 配置API登录：运行
tdl login -n my_session，按提示输入API ID/Hash和手机号。 - 导出消息：
tdl chat export -n my_session -t 聊天ID -o messages.json
tdl还支持批量导出、增量备份等高级功能，适合需要长期维护备份的用户。
实用建议与注意事项
- 隐私保护：JSON文件可能包含敏感信息，导出后请妥善保管，避免上传至公开仓库。
- 大文件处理：如果聊天记录庞大，建议分批导出或使用脚本按日期切割。
- 媒体文件：JSON本身不包含图片或视频，但桌面版导出时会将媒体文件一并保存在一个文件夹中，JSON中会用路径引用。
- 群组导出：以上方法均支持群组，只需将群组对象作为目标实体。
- 持续更新：Telegram API可能会更新，请保持库和工具的版本最新。
总结
无论您是普通用户还是开发者，将Telegram聊天记录导出为JSON都有多种途径。桌面版适合快速备份，Telethon脚本适合定制化需求，而tdl则适合命令行爱好者。选择适合自己的方式，让聊天数据真正掌握在自己手中。如果您在操作中遇到问题，欢迎在评论区交流。