第1章:开发环境搭建

各位同学,咱们正式开始。做物联网监控系统,第一步就是把开发环境整利索。我见过太多人,代码写了一半才发现环境有问题,那叫一个头疼。今天咱们就把这事一次性搞定。

1.1 Python环境配置

Python版本怎么选?我个人习惯用Python 3.9或3.10。为什么?因为这两个版本对paho-mqtt和influxdb的兼容性最好。你想想看,要是装个库报一堆错,多耽误事。

下载地址我直接告诉你:python.org,别去其他地方乱下。安装时记得勾选「Add Python to PATH」,这个坑我踩过——没勾选的话,命令行里敲python就找不到。

小提示:安装完成后,打开命令行输入 python --version,看到版本号就说明成了。

1.2 虚拟环境创建

虚拟环境这东西,说白了就是给每个项目一个独立的小房间。你在这个房间里装什么库,都不会影响到别的项目。我在项目中遇到过好几次,两个项目依赖同一个库的不同版本,没有虚拟环境的话,那叫一个乱。

创建虚拟环境很简单,就两行命令:

# 创建虚拟环境
python -m venv sensor_env

# 激活虚拟环境
# Windows:
sensor_env\Scripts\activate
# Mac/Linux:
source sensor_env/bin/activate

激活后,命令行前面会出现 (sensor_env) 字样,这就对了。嗯,这里要注意:每次打开新终端,都要重新激活一下。

避坑指南:我曾经在Windows上用PowerShell激活虚拟环境,结果报了个执行策略错误。解决方法:用管理员身份打开PowerShell,先执行 Set-ExecutionPolicy Unrestricted,再激活就好了。

1.3 核心库安装

好,环境有了,虚拟环境也激活了,接下来装库。咱们这个项目需要四个核心库:

库名 版本建议 作用
paho-mqtt 1.6.1 MQTT协议通信,接收传感器数据
influxdb 5.3.1 时序数据库,存储传感器数据
pandas 1.5.3 数据处理与分析
matplotlib 3.7.1 数据可视化,绘制图表

安装命令也很直接:

pip install paho-mqtt==1.6.1 influxdb==5.3.1 pandas==1.5.3 matplotlib==3.7.1

为什么要指定版本?你想想看,新版本可能改了API,咱们照着教程写代码,结果跑不起来,多尴尬。我建议就用这些版本,等课程学完了,你再自己去探索新版本。

验证安装:装完后,在Python交互环境里依次导入这四个库,不报错就说明全部搞定。

1.4 本章知识体系

下面这张图,把咱们这章的核心逻辑串起来了。你看一遍,心里就有数了:

开发环境搭建核心流程 Python 3.9/3.10 虚拟环境 sensor_env pip install 核心库 paho-mqtt MQTT通信 influxdb 时序数据库 pandas 数据处理 matplotlib 数据可视化 验证:import 四个库,不报错即成功

这张图把咱们这章做的事都串起来了。从装Python开始,到创建虚拟环境,再到装四个核心库,最后验证。每一步都是下一步的基础,缺一不可。

1.5 常见问题与解决

我整理了几个新手最容易碰到的问题,你看看:

  • pip不是内部或外部命令——说明Python没加到PATH里,重装时勾选那个选项就行。
  • 安装库时超时——国内网络问题,加个镜像源:pip install -i https://pypi.tuna.tsinghua.edu.cn/simple 库名
  • 虚拟环境激活后pip还是全局的——检查一下终端路径,确保在虚拟环境目录下操作。
我的习惯:每次开始写代码前,先激活虚拟环境,然后运行一下测试脚本,确认所有库都能正常导入。这花不了1分钟,但能省下后面排查问题的半小时。

好了,环境搭建就这些内容。你跟着做一遍,应该10分钟就能搞定。下一章咱们就开始写真正的代码了——连接MQTT服务器,接收传感器数据。


公众号:蓝海资料掘金营,微信deep3321