常见问题与支持（FAQ & Support）

一、通用问题

Q：插件无法安装怎么办？
A：请确认您的 IDE 版本符合插件最低要求（如 VS Code ≥ 1.82，IDEA ≥ 2024.1）。若仍失败，请尝试：
- 重启 IDE 后重试安装
- 手动下载 .vsix 文件离线安装
- 检查网络代理或企业防火墙设置
Q：登录失败是什么原因？
A：可能原因包括：
- 账号未实名认证审核通过
- 网络连接异常（无法访问认证服务）
- 账号密码错误
- 本地时间与服务器时间偏差过大（影响 Token 验证）
请依次检查网络、凭证，并确保系统时间准确。
Q：插件登录打开页面登录失败怎么办？
A：这通常与浏览器兼容性有关。部分浏览器（如 360 浏览器）在处理登录跳转或OAuth认证时可能存在兼容问题。
解决办法：
- 更换为兼容浏览器：请将默认浏览器临时切换为 Chrome（推荐）；
- 重试登录流程：在 IDE 右下角点击“取消登录”，然后重新通过插件发起登录；
- 清理环境（可选）：若问题依旧，可尝试清除浏览器缓存，或在无痕/隐私模式下重新登录。
请依次检查网络、凭证，并确保系统时间准确。
Q：插件运行缓慢或卡顿？
A：建议执行以下操作：
- 关闭非必要后台插件以释放资源

Q：数据库或工作流页面能打开，但无数据加载？
A：请按以下步骤排查：
1. 确认 JDK 版本
  确保使用 JDK 8 至 JDK 17之间的版本（不支持 JDK 21+ 非 LTS 版本）。
2. 检查配置文件
  查看 vjspai-link.yml 中的数据库连接信息（URL、用户名、密码、驱动类）是否正确。
3. 验证文件位置
  vjspai-link.yml 必须位于 项目根目录（与 pom.xml 同级），否则启动时无法加载。
若配置无误但仍无数据，请确认后端接口是否返回空结果集，或联系技术支持。
Q：右键菜单中没有“VJSP编辑”选项？
A：请确认：
- VJSP 插件已成功安装并启用
- 当前选中的是项目文件 /src/main/resources/static/vjsphtml/*.html 文件（仅支持 VJSP 标准表单格式）
Q：保存后代码未更新？
A：可能原因：
- 文件被其他程序锁定（如 Git、杀毒软件）
- 文件处于只读状态
  解决方案：关闭文件后重新打开，或手动刷新资源管理器。

若遇到未列出的问题，请按以下顺序排查：

如问题仍未解决，欢迎联系 VJSP 技术支持团队：

我们将尽快为您提供帮助！