快速开始
本文将帮助你在 5 分钟内完成 pywxauto 的安装、激活和第一次使用。
环境要求
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 10 / 11 |
| Python | >= 3.8 |
| 微信客户端 | Windows 4.x 版本，已登录 |
安装
使用 pip 一键安装：
bash
pip install pywxauto安装完成后验证：
bash
python -c "import pywxauto; print(pywxauto.__version__)"建议
推荐使用虚拟环境来管理依赖，避免包冲突：
bash
python -m venv .venv
.venv\Scripts\activate
pip install pywxauto激活
使用前需要通过授权码激活当前设备。授权码为 XXXX-XXXX-XXXX-XXXX 格式。
命令行激活（推荐）
bash
pywxauto -a XXXX-XXXX-XXXX-XXXX激活成功后会输出授权信息，包括方案类型和到期时间。
Python 代码激活
python
from pywxauto import license_activate
result = license_activate("XXXX-XXXX-XXXX-XXXX")
print(result) # {'license_key': '...', 'plan': 'pro', 'expires_at': '...'}说明
- 每个授权码绑定固定数量的设备，激活后当前机器即完成绑定
- 激活状态会定期在线校验，确保网络可用
- 如需更换设备，请联系管理员解绑后重新激活
查看授权状态
python
from pywxauto import license_verify
is_valid, message = license_verify()
print(f"授权状态: {message}")使用
激活成功后，确保微信 Windows 客户端已登录，即可开始使用。
发送消息
python
from pywxauto import Weixin
# 连接微信（自动识别已登录的微信窗口）
wx = Weixin()
# 发送文本消息
wx.send_text("文件传输助手", "Hello from pywxauto!")
# 发送图片
wx.send_image("文件传输助手", "C:/photos/test.png")
# 发送文件
wx.send_file("文件传输助手", "C:/docs/report.pdf")消息监听
python
from pywxauto import Weixin, Event
wx = Weixin()
@wx.on(Event.TEXT)
def on_text(weixin, chat, message):
print(f"{message.sender}: {message.content}")
# 自动回复
chat.send_text(f"收到: {message.content}")
# 添加监听目标
wx.add_chat_listen(["张三", "工作群"])
# 启动监听（阻塞运行，Ctrl+C 退出）
wx.run()朋友圈
python
from pywxauto import Weixin
wx = Weixin()
# 发布纯文字朋友圈
wx.publish_moment(text="今天天气真好")
# 发布图文朋友圈
wx.publish_moment(
text="周末出游",
images=["photo1.jpg", "photo2.jpg"]
)