PCM_Viewer/TROUBLESHOOTING.md

# 故障排除指南

## 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. 检查网络连接和防火墙设置