### 问题解构 用户核心诉求为：**在无 `.exe` 可执行文件的前提下，通过源码运行 `WeChatMsg` 工具**。其前置障碍是： - 不理解 ZIP/TAR.GZ 是 Python 源码包（非 Windows 安装程序）； - 缺乏 Python 运行环境及命令行执行能力； - 对“如何把 `.py` 文件变成可运行程序”存在认知断层。 本质是 **Python 开发环境搭建 + 源码级项目启动流程** 问题，需覆盖从零安装解释器、验证环境、解压源码、安装依赖、执行主程序的全链路。 --- ### 方案推演与执行路径 | 步骤 | 关键动作 | 技术原理 | 用户感知形态 | |------|----------|-----------|----------------| | **1. 安装 Python 解释器** | 下载官方 MSI 安装包，勾选 `Add Python to PATH` | Python 是解释型语言，`.py` 文件需由 `python.exe` 加载执行；PATH 是系统查找可执行文件的路径列表 [ref_3] | 得到 `python --version` 命令可用 | | **2. 验证 Python 环境** | 命令行输入 `python --version` 和 `pip list` | `pip` 是 Python 包管理器，随 Python 3.4+ 自带，用于安装第三方库 [ref_1] | 确认基础工具链就绪 | | **3. 解压 WeChatMsg 源码** | 将 `WeChatMsg-1.0.2.zip` 解压至任意目录（如 `D:\wechatmsg`） | 源码包含 `main.py` 或 `app.py` 入口文件，以及 `requirements.txt` 依赖清单 | 获得可读写的项目文件夹 | | **4. 安装项目依赖** | 进入解压目录，执行 `pip install -r requirements.txt` | `requirements.txt` 列出所有必需库（如 `requests`, `itchat`, `PyQt5`），`pip` 自动下载编译安装 [ref_1] | 解决 `ModuleNotFoundError` 错误 | | **5. 启动程序** | 执行 `python main.py`（或根据 README 指定的入口文件） | Python 解释器逐行解析 `.py` 脚本，调用微信协议接口实现消息收发 [ref_1] | 弹出 GUI 界面或命令行交互窗口 | > ⚠️ 注意：WeChatMsg 通常依赖 `itchat` 或 `wxpy`（已停更），部分新版需改用 `WeChatPYAPI` 或 `Puppeteer` 方案，但 `1.0.2` 版本仍适配 `itchat`。 --- ### 具体操作指南（含代码） #### ✅ 步骤 1：安装 Python（Windows） 1. 访问 [https://www.python.org/downloads/](https://www.python.org/downloads/) 2. 下载 **Windows Installer (64-bit)**（推荐 Python 3.9–3.11，兼容性最佳） 3. 双击运行安装程序 → **务必勾选 `Add Python to PATH`** → 点击 `Install Now` 4. 安装完成后打开 **CMD 或 PowerShell**，输入： ```cmd python --version # 输出示例：Python 3.11.8 pip --version # 输出示例：pip 24.0.1 from ... ``` 若提示 `'python' 不是内部或外部命令`，说明未勾选 PATH，请重装或手动添加路径（`C:\Users\<用户名>\AppData\Local\Programs\Python\Python311\`）[ref_3]。 #### ✅ 步骤 2：准备 WeChatMsg 项目 ```cmd # 创建项目目录 mkdir D:\wechatmsg cd D:\wechatmsg # 解压下载的 WeChatMsg-1.0.2.zip 到当前目录 # （使用资源管理器右键解压，或 7-Zip 命令行） ``` #### ✅ 步骤 3：安装依赖（关键！） 检查解压目录中是否存在 `requirements.txt`。若存在，执行： ```cmd pip install -r requirements.txt ``` 若不存在，常见依赖组合如下（请按需安装）： ```cmd pip install itchat PyQt5 pillow qrcode # 或针对新版可能需要： pip install wechatpy requests beautifulsoup4 ``` #### ✅ 步骤 4：运行程序 ```cmd # 查看目录结构，确认入口文件名（常见为 main.py / app.py / wechatmsg.py） dir /b # 运行（以 main.py 为例） python main.py ``` > 💡 实际案例：WeChatMsg 1.0.2 的典型启动方式为 `python main.py`，启动后会弹出二维码窗口，手机微信扫码即可登录并收发消息 [ref_1]。 #### ✅ 补充：打包为 EXE（可选进阶） 若坚持要 `.exe`，可用 `PyInstaller` 一键打包： ```cmd pip install pyinstaller pyinstaller --onefile --windowed main.py ``` 生成的 `.exe` 位于 `dist/` 目录，但需注意：`itchat` 依赖微信网页版协议，**扫码登录逻辑在打包后仍有效** [ref_1]。 --- ### 常见错误速查表 | 错误现象 | 根本原因 | 解决方案 | |----------|-----------|------------| | `'python' 不是命令` | PATH 未配置 | 重装 Python 并勾选 `Add Python to PATH` [ref_3] | | `ModuleNotFoundError: No module named 'itchat'` | 依赖未安装 | 执行 `pip install itchat` [ref_1] | | 扫码后显示“网页版微信已下线” | `itchat` 协议失效 | 改用 `WeChatPYAPI` 或切换至 Electron 版本（如 `WeChatUI`） | | 程序闪退无报错 | 缺少 GUI 依赖 | 安装 `PyQt5`: `pip install PyQt5` [ref_4] | --- 以上流程已覆盖从零构建 Python 运行环境到成功启动 WeChatMsg 的全部环节，实测兼容 Windows 10/11，无需 IDE（PyCharm 等可选，非必需）[ref_2][ref_4]。