快速开始

前置条件

• Python >= 3.8
• Windows 操作系统
• 微信客户端（支持的版本见版本兼容）
• 微信号必须设置头像，否则框架无法正常运行

安装

pip install pywechat

最简示例

from pywechat import WeChat, events

# 初始化，指定微信版本
wechat = WeChat("4.1.2.17")

@wechat.handle(events.USER_LOGIN_MESSAGE)
def on_login(bot: WeChat, event: dict):
    print(f"已登录：{event}")

@wechat.handle(events.TEXT_MESSAGE)
def on_text(bot: WeChat, event: dict):
    print(f"收到文本消息：{event}")
    # 自动回复（排除自己发送的消息）
    if event["data"]["from_wxid"] != bot.client["wxid"]:
        bot.send_text(
            event["client_id"],
            event["data"]["from_wxid"],
            event["data"]["msg"]
        )

wechat.run()

工作流程

1. 初始化：WeChat("4.1.2.17") 会自动启动 Hook 服务并接管微信客户端
2. 注册事件：通过 @wechat.handle(event_type) 装饰器注册回调函数
3. 运行：调用 wechat.run() 进入事件循环，接收并处理微信消息

关闭调试日志

from loguru import logger
logger.remove()

# 或者通过环境变量控制日志级别
import os
os.environ["PYWECHAT_LOG_LEVEL"] = "INFO"

微信 4.x 首次使用

微信 4.x 版本首次使用本框架时，请运行示例代码调起微信后扫码登录。

解除 3.x 低版本限制

# bypass_version=True 自动解除微信3.x低版本登录限制
wechat = WeChat("3.9.10.19", bypass_version=True)