pg官网平台常见问题：安装、登录到报错代码逐条排查

先核对文件体积是否与下载页标注的一致，如果明显偏小，说明下载过程被中途打断，建议换一个稳定的网络环境重新下载一次。

Windows 端可以右键查看文件属性，确认文件没有被系统标记为来自其他位置，如有该提示请解除锁定后再试；安卓端需要在系统设置中允许安装来自浏览器或文件管理器的应用。

多数情况是目标磁盘剩余空间不足，或者安装目录被其他进程占用。请先关闭正在运行的同名程序，再确认安装盘至少保留 2GB 可用空间。

如果空间充足仍然失败，可以把安装路径更换到不含中文与空格的目录，例如直接安装在盘符根目录下的新建文件夹中，然后重新执行安装。

这类提示通常出现在精简版或长期未更新的系统上。请先确认系统版本满足 3.8.2 的要求，然后重新运行安装包并选择修复安装。

安装程序会自动补齐缺失的运行库，修复完成后重启一次系统再打开客户端。若修复安装依旧提示相同内容，把系统版本号记下来一并提交，便于进一步确认。

先检查输入法是否处于全角状态，密码中的符号在全角下会被判定为错误字符，这是最容易被忽略的一种情况。

如果切换半角后仍提示错误，可以改用手机验证码方式登录，成功之后在账号设置里重新设置一次密码，桌面端与移动端会同步生效。

出于账号安全考虑，连续 30 天未使用的登录状态会自动失效，需要重新登录一次，这属于正常机制。

如果短时间内频繁被退出，可以检查系统时间是否准确、是否开启了清理工具定时清除应用数据。系统时间与标准时间偏差超过 5 分钟 会导致凭证校验失败。

先确认两台设备登录的是同一个账号，再检查当前网络是否可用。同步一般在登录后 1 分钟内完成。

如果进度条长时间停在中间，可以在设置的同步选项中手动触发一次同步，或者在列表上执行一次下拉刷新强制拉取最新内容。

常规的覆盖安装不会清除配置与本地偏好，常用设置会保留下来，登录状态一般也不需要重新输入。

为稳妥起见，更新前可以在设置中导出一次配置备份文件。更新完成后如果发现界面回到默认状态，导入这份备份即可恢复常用设置。

卸载程序默认只移除客户端本体，本地缓存目录会被保留，因此重装之后通常可以直接沿用原有设置。

如果需要彻底清理，可以在卸载完成后手动删除安装路径下的数据文件夹。已经同步到账号的内容不受影响，重新登录即可恢复。

先完全关闭客户端并结束后台残留进程，再重新打开观察是否恢复正常。多数卡顿是一次性的，重启后即可进入主界面。

如果问题反复出现，可以在启动时按住 Shift 进入轻量模式，跳过扩展加载。确认是扩展引起的，再逐个打开扩展定位具体来源。

3-2018 表示本次请求的登录凭证已经过期，常见于系统休眠唤醒之后，属于需要重新获取凭证的提示。

关闭客户端并重新打开即可自动获取新凭证。如果同一代码在一天内重复出现三次以上，请把运行日志一并提交，便于确认是否为网络环境导致的反复失效。

在客户端左上角菜单进入设置，选择「运行日志」一项，可以看到最近 7 天的记录，按时间倒序排列。

点击导出会生成一个压缩包，内含日志文本与基础设备信息。提交问题时附上该文件，可以省去反复确认系统环境和版本号的步骤。

客户端默认使用标准端口，在部分办公或公共网络中可能被拦截，表现为一直停留在连接中。

此时可以在设置的连接方式中切换到备用通道，或者先改用手机热点验证一次。如果备用通道可用，说明是当前网络的策略限制，并非客户端本身的问题。