2、开发环境搭建与工具准备：安装Python 3.x、Postman、VS Code，配置虚拟环境，安装requests库

好，咱们正式开始动手了。

做CRM集成开发，说白了就是跟各种API打交道。你想想看，没有趁手的工具，就像厨师没有好刀一样，再好的菜也做不出来。这一章，我带你把开发环境从头到尾捋一遍。嗯，都是些基本功，但千万别小看这一步——我在项目里见过太多人因为环境问题浪费一整天。

2.1 安装Python 3.x

Python 3.x 是咱们的主力语言。为什么选它？因为生态好，库多，写起来快。CRM集成这种活儿，最怕的就是重复造轮子，Python 的 requests 库简直就是为API调用量身定做的。

下载与安装

去官网 python.org 下载最新版。我个人习惯用 3.9 或 3.10，稳定，坑少。安装时记得勾选「Add Python to PATH」，这个很多人会忘。

注意： 如果你用的是 macOS 或 Linux，系统可能自带 Python 2.x。千万别用那个！Python 2 已经退休了，很多新库都不支持。我曾经在一个老项目里被迫用 Python 2 调 API，结果有个加密库死活装不上，折腾了两天……后来换了 Python 3，十分钟搞定。

安装完成后，打开终端（Windows 用 cmd 或 PowerShell），输入：

python --version

如果看到类似 Python 3.9.7 的输出，就说明装好了。

2.2 安装 VS Code

编辑器我推荐 VS Code。免费、轻量、插件多。你想想看，一个编辑器能搞定代码编辑、调试、Git 管理、甚至数据库查询，多省心。

推荐插件

  • Python（微软官方出品）—— 语法高亮、智能提示、调试一把抓
  • Prettier —— 代码格式化，团队协作时特别有用
  • REST Client —— 有时候不想开 Postman，直接在 VS Code 里调 API，很方便

安装好之后，打开 VS Code，按 Ctrl+Shift+P（Mac 是 Cmd+Shift+P），输入 Python: Select Interpreter，选你刚装的那个 Python 版本。这一步很多人会忽略，结果代码跑起来发现用的是系统自带的 Python 2，各种报错。

2.3 安装 Postman

Postman 是 API 调试的神器。我刚开始做集成的时候，全靠它来验证接口通不通、返回什么格式的数据。说白了，它就是你的「API 试金石」。

去 postman.com 下载桌面版。网页版也能用，但我建议用桌面版，功能更全，响应也快。

Postman 的几个核心用法

  • 发送 GET/POST 请求 —— 最基本的操作，测试接口是否可达
  • 管理环境变量 —— 比如把 base_url 设成变量，开发、测试、生产环境一键切换
  • 保存请求历史 —— 调过的接口都留着，方便回头查
小技巧： 在 Postman 里调通一个接口后，可以直接生成 Python 代码。点一下右侧的「Code」按钮，选「Python - Requests」，代码就出来了。复制粘贴就能用，省时省力。

2.4 配置虚拟环境

为什么要用虚拟环境？

你想想看，一个项目用 requests 2.25，另一个项目用 requests 2.26，如果都装到全局，迟早会打架。虚拟环境就是给每个项目一个独立的「小房间」，互不干扰。

创建虚拟环境

打开终端，进到你的项目目录，然后运行：

python -m venv venv

这条命令会在当前目录下生成一个 venv 文件夹。里面就是独立的 Python 解释器和库。

激活虚拟环境

  • Windows：venv\Scripts\activate
  • macOS/Linux：source venv/bin/activate

激活后，终端前面会出现 (venv) 字样，说明你已经在虚拟环境里了。

注意： 我见过有人把 venv 文件夹提交到 Git 仓库里。千万别这么做！虚拟环境是本地的东西，不同系统、不同 Python 版本生成的都不一样。正确的做法是在项目根目录加一个 .gitignore 文件，把 venv/ 写进去。

2.5 安装 requests 库

终于到了最核心的一步。requests 库是 Python 里最流行的 HTTP 库，没有之一。它的口号是「HTTP for Humans」，说白了就是让你用最少的代码完成 API 调用。

在虚拟环境激活的状态下，运行：

pip install requests

装完之后，可以验证一下：

python -c "import requests; print(requests.__version__)"

如果输出版本号，比如 2.28.1，就说明安装成功了。

一个简单的测试

咱们用 requests 调一个公开的 API，看看效果：

import requests

response = requests.get('https://api.github.com')
print(response.status_code)
print(response.json())

如果返回 200 和一堆 JSON 数据，恭喜你，环境搭建完成！

核心要点总结

  • Python 3.x 是基础，记得勾选「Add to PATH」
  • VS Code 装好 Python 插件，选对解释器
  • Postman 用来调试接口，能直接生成 Python 代码
  • 虚拟环境用 python -m venv venv 创建，记得激活
  • requests 库用 pip install requests 安装

嗯，到这里，开发环境就齐活了。下一章咱们开始写真正的 CRM 集成代码，到时候你会感谢自己今天把环境搭得这么干净。

← 上一章 📖 返回目录 下一章 →