PCM_Viewer/TROUBLESHOOTING.md

59 lines
1.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 故障排除指南
## QtQuick 插件加载失败
如果遇到以下错误:
```
无法加载库 ... qtquick2plugin.dll找不到指定的模块。
```
### 解决方案 1安装 Visual C++ Redistributable
这是最常见的原因。请下载并安装:
- **Visual C++ Redistributable 2015-2022 (x64)**
- 下载地址https://aka.ms/vs/17/release/vc_redist.x64.exe
- 安装后重启计算机
### 解决方案 2重新安装 PySide6
```bash
pip uninstall PySide6 PySide6-Essentials PySide6-Addons -y
pip install PySide6==6.7.0
```
### 解决方案 3检查系统环境
确保系统 PATH 环境变量中包含必要的路径,或者尝试在管理员权限下运行程序。
### 解决方案 4使用虚拟环境
创建一个新的虚拟环境并重新安装:
```bash
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt
```
## 其他常见问题
### 模块导入错误
如果遇到 `ModuleNotFoundError`,请确保:
1. 已安装所有依赖:`pip install -r requirements.txt`
2. Python 版本兼容(推荐 Python 3.8+
### InfluxDB 连接问题
如果无法连接到 InfluxDB
1. 检查 InfluxDB 服务是否运行
2. 验证 URL、Token、Organization 和 Bucket 配置
3. 检查网络连接和防火墙设置