求助：为MQTT通信通过pip安装uwebsockets失败

数据老陈

2026-7-14

解决 pip install uwebsockets 编译失败问题

先核实包名是否正确：MQTT项目常用的WebSocket库是websockets，不少用户会误写成uwebsockets。如果是这个情况，执行以下命令安装正确的包：
```
pip install websockets
```
若你确实需要安装uwebsockets，编译失败的核心原因是缺少编译依赖，针对不同系统处理：
- Windows：安装Visual Studio Build Tools，勾选「C++开发工具」组件，确保包含MSVC编译器与Windows SDK。
- Debian/Ubuntu：安装基础编译套件和Python开发包：
```
sudo apt update && sudo apt install build-essential python3-dev
```
- RHEL/CentOS：安装开发工具组和Python开发包：
```
sudo yum groupinstall "Development Tools" && sudo yum install python3-devel
```
- macOS：安装Xcode命令行工具：
```
xcode-select --install
```
升级pip、wheel和setuptools到最新版本，避免工具版本过低导致的兼容性问题：
```
pip install --upgrade pip wheel setuptools
```
若上述步骤无效，尝试手动安装预编译wheel包（如果PyPI上提供对应版本）：下载匹配你系统和Python版本的uwebsockets wheel文件后，执行本地安装：
```
pip install /本地路径/uwebsockets-对应版本.whl
```