Windows 常见问题
本页汇总在 Windows 系统上部署 MaiBot 时可能遇到的常见问题及解决方法。若遇到其他问题，欢迎在 Issue 或群组中反馈。
1. 依赖安装问题
Q：在安装依赖时 quick_algo 安装失败怎么办？
如果在使用 uv pip install 或 pip install 安装依赖时遇到 quick_algo 编译/安装失败，请参考以下步骤：
- 确认编译环境：确保已安装 Visual C++ 构建工具或 MinGW 等 C/C++ 编译环境。
- 参考 LPMM 文档：
quick_algo是 LPMM（语言模型内存管理）模块的底层依赖，其安装方法详见 LPMM 知识库 中“安装 quick-algo”或“手动编译”部分。 - 临时跳过：若仅用于测试，可尝试注释掉
requirements.txt中quick_algo相关行（但不推荐长期使用）。
注意：该问题在使用 uv 或传统 pip 安装时均可能出现，解决方法相同。
2. 虚拟环境问题
Q：使用 uv 和传统 venv 有什么注意事项？
uv venv创建的虚拟环境与python -m venv创建的虚拟环境机制不同，不要混合使用。- 使用
uv时，推荐全程使用uv run命令运行脚本，它会自动管理虚拟环境。 - 使用传统 venv 时，每次运行前需手动激活：
.\venv\Scripts\activate（PowerShell）或venv\Scripts\activate.bat（CMD）。
3. 其他常见问题
Q：Napcat 连接不上怎么办？
- 确认 Napcat 已正常启动，并在 Napcat 中创建了 WebSocket 客户端（反向代理）。
- 检查
MaiBot-Napcat-Adapter/config.toml中[Napcat_Server]的host和port是否与 Napcat 设置一致。 - 确保 MaiBot 本体的
.env中PORT与[MaiBot_Server]的port一致。 - 防火墙可能阻止本地端口通信，可临时关闭防火墙测试。
Q：启动时报“端口已被占用”错误？
修改 .env 文件中的 PORT 值为其他未被占用的端口（如 8001、8080 等），并同步更新 Adapter 配置中的 [MaiBot_Server].port。