2、开发环境准备：Python环境安装、pip包管理工具、requests库安装、企业微信开发者后台配置
说实话，很多同学学企业微信机器人开发，第一步就卡住了。
不是代码写不出来，而是环境没配好。我见过太多人，Python装了好几个版本，pip用不了，requests库死活装不上……折腾一上午，热情全没了。
所以这一章，咱们把环境一次性搞定。你跟着我的节奏走，半小时内就能跑起来。
2.1 Python环境安装
Python版本怎么选？我个人习惯用Python 3.8+。为什么？因为企业微信的API接口对3.8以上的版本支持最好，而且很多第三方库在3.8上跑得最稳。
你想想看，要是装了个Python 3.12，有些老库还没适配，到时候报错你都不知道去哪查。
Windows安装步骤
- 去Python官网下载安装包，选Windows installer (64-bit)
- 安装时一定要勾选「Add Python to PATH」
- 点「Install Now」，等几分钟就好
macOS安装步骤
- 建议用Homebrew安装：
brew install python@3.10 - 或者去官网下载pkg安装包
Linux安装步骤
# Ubuntu/Debian
sudo apt update
sudo apt install python3.10 python3.10-venv python3.10-dev
# CentOS/RHEL
sudo yum install python3.10装完之后，打开终端输入 python --version，看到版本号就说明成功了。
python3 而不是 python，因为有些系统默认的python指向的是Python 2。你可以在终端试一下，哪个能跑就用哪个。
2.2 pip包管理工具
pip是Python的包管理工具，说白了就是帮你下载和管理第三方库的。Python 3.4以上的版本都自带pip，不用单独装。
怎么验证pip装好了？运行：
pip --version如果看到类似 pip 23.0.1 from ... 的信息，就说明没问题。
嗯，这里要注意：有时候pip会提示版本太旧，建议升级。那就升呗：
pip install --upgrade pippip install 包名— 安装包pip uninstall 包名— 卸载包pip list— 查看已安装的包pip freeze > requirements.txt— 导出依赖清单pip install -r requirements.txt— 批量安装依赖
为什么要用requirements.txt？我在项目里吃过亏。有一次换电脑，忘了记自己装过哪些库，结果一个个重新装，折腾了半小时。从那以后，每个项目我都习惯先 pip freeze > requirements.txt，换环境直接 pip install -r 搞定。
2.3 requests库安装
企业微信的API调用，说白了就是发HTTP请求。Python里最常用的HTTP库就是requests。它比自带的urllib好用太多了，代码写起来也简洁。
安装就一句话：
pip install requests验证一下：
python -c "import requests; print(requests.__version__)"看到版本号就说明装好了。
pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple。我每次配新环境都会先配好镜像源，省得下载慢。
2.4 企业微信开发者后台配置
环境搭好了，接下来要配置企业微信的后台。这一步很多人觉得麻烦，其实就几个关键点。
2.4.1 登录开发者后台
打开浏览器，访问企业微信开发者后台（https://work.weixin.qq.com/wework_admin/frame#apps）。用企业微信的管理员账号扫码登录。
2.4.2 创建应用
- 在「应用管理」页面，点击「创建应用」
- 上传应用Logo，填写应用名称（比如「运维机器人」）
- 选择可见范围（建议先选一个小部门测试）
- 点击「创建应用」
2.4.3 获取关键配置信息
创建成功后，你会看到三个关键信息：
| 配置项 | 说明 | 获取位置 |
|---|---|---|
| CorpID | 企业ID，每个企业唯一 | 「我的企业」→「企业信息」 |
| AgentID | 应用ID，每个应用唯一 | 应用详情页顶部 |
| Secret | 应用密钥，调用API时用 | 应用详情页 → 「Secret」 |
2.4.4 配置IP白名单
在企业微信后台，找到「应用管理」→ 你的应用 → 「企业可信IP」。把你服务器的公网IP填进去。如果不填，API调用会被拒绝。
怎么查自己服务器的公网IP？运行：
curl ifconfig.me2.4.5 配置回调URL（可选但推荐）
如果你想让机器人主动接收消息，需要配置回调URL。在应用详情页找到「接收消息」→ 设置API接收。
URL格式：http://你的域名或IP/callback
Token和EncodingAESKey可以随机生成，后面写代码时会用到。
- CorpID
- AgentID
- Secret
- 企业可信IP（你的服务器IP）
把这4样记下来，后面写代码全都要用。
2.5 验证环境是否就绪
最后，咱们写个简单的Python脚本，验证一下整个链路通不通：
import requests
import json
# 配置信息（替换成你自己的）
corpid = "你的CorpID"
corpsecret = "你的Secret"
# 获取access_token
url = f"https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid={corpid}&corpsecret={corpsecret}"
response = requests.get(url)
data = response.json()
if data.get("errcode") == 0:
print("✅ 环境配置成功！access_token:", data["access_token"][:10] + "...")
else:
print("❌ 出错了：", data.get("errmsg"))如果看到 ✅ 环境配置成功！，恭喜你，环境全部就绪，可以开始写机器人代码了。
如果报错，别慌。检查一下CorpID和Secret有没有填对，IP白名单配了没。我遇到过最坑的一次，是复制Secret时多复制了一个空格……嗯，这种低级错误我也犯过。