VRCX 故障排查指南5 分钟快速诊断并修复 VRChat 好友管理工具常见 8 大问题【免费下载链接】VRCXFriendship management tool for VRChat项目地址: https://gitcode.com/GitHub_Trending/vr/VRCX本文面向 VRCX 的新手和日常用户当 VRCX 打不开、VRChat 登录认证失败、好友管理功能不更新或截图数据丢失时按本故障排查指南的场景逐步诊断多数问题 5 分钟内即可修复。30 秒自查排障前先把这 4 件事做完 任何场景下手之前先花 30 秒过一遍这里。很多VRCX 坏了的表象其实是下面这些基础原因版本太旧在设置 通用查看当前版本号明显落后就切换到最新正式版同页的更改版本还能拿到 nightly 构建。网络不稳VRCX 全程依赖 VRChat API 拉取好友、世界、模型数据代理抽风会直接表现为列表空白。先换网络或重启代理再试。VRChat 服务宕机登录页带有 VRChat 服务状态提示官方服务故障期间登录和同步都不会成功等待恢复即可。先看日志主日志在%APPDATA%\VRCX\logs\VRCX.log叠加层进程单独写VRCX.Overlay.log路径定义见 Dotnet/Program.cs。问题复现后翻最后几行找 ERROR 最快。四项都排除了再对照下表定位到对应章节问题先查什么相关日志或路径程序打不开或闪退.NET 运行时、杀软误杀、版本%APPDATA%\VRCX\logs\VRCX.log登录认证失败密码、两步验证码、VRChat 服务状态%APPDATA%\VRCX\logs\VRCX.log好友列表不更新网络/代理、手动刷新、API 限频%APPDATA%\VRCX\VRCX.json截图缺少世界信息PNG 格式、保存目录可写设置 截图中的保存位置自动启动未触发绝对路径、程序能否手动运行%APPDATA%\VRCX\startup\Discord 状态不更新连接状态、活动展示权限%APPDATA%\VRCX\logs\VRCX.log程序打不开或闪退怎么排查双击安装包没反应或刚启动就关闭最常见的原因是 .NET 运行时缺失或安装过程中组件被安全软件隔离。确认系统是 Windows 10/1164 位Linux 用户需按官方说明在 Wine 环境下部署。暂时关闭杀毒软件的实时防护重新执行安装装完再打开。仍报错就打开VRCX.log查看具体异常如果连日志文件都没有生成多半是程序根本没装完整卸载后重新下载最新正式版。启动后闪退或窗口白屏优先怀疑配置文件损坏它比驱动问题常见得多。把%APPDATA%\VRCX\VRCX.json重命名为VRCX.json.bak重启程序看是否恢复正常。恢复不了就更新显卡驱动白屏常与图形渲染有关。依然闪退时对照日志时间戳和崩溃时间点找到抛出错误的模块这段日志后面反馈问题时一定要附上。登录提示认证失败或两步验证过不去输入密码后提示认证失败 多半是密码打错或者是 VRChat 服务端本身出了问题登录页相关逻辑见 src/views/Login/。重新输入账号密码检查首尾多余空格确认大小写锁定已关闭。留意登录页的服务状态提示若显示 VRChat 故障等服务恢复再试——这是最容易被忽略的一种情况。到 VRChat 官网确认密码仍然有效必要时走忘记密码重置。仍失败时在日志中搜索服务端返回的具体错误判断是账号问题还是网络问题。两步验证码输完还是进不去这个坑很隐蔽验证码要填在弹出的验证弹窗里而不是拼在密码框后面。提交账号密码后如果账号开启了两步验证会自动弹出验证窗口等它出现再继续操作。在验证器 App 里重新生成 TOTP 码再输入旧码 30 秒就失效手慢就换新的。验证器 App 丢失的话看弹窗里能否切换成邮箱 OTP 验证相关接口在 src/api/auth.ts。好友列表或在线状态不更新怎么修好友一直显示离线或列表整片空白最可能的原因是缓存没刷新其次是 VRChat API 限频列表组件在 src/views/FriendList/FriendList.vue。先手动点刷新按钮强制拉一次数据别干等自动同步。如果网络走了代理先关掉或换成更稳定的线路再刷新一次。整片空白通常是触发了限频等几分钟再试连续狂点刷新反而更糟。仍无变化时翻日志里具体的请求失败记录确认是网络问题还是账号侧问题。在线了但位置和世界信息缺失状态数据本身有同步延迟先等一个周期再到好友位置页面查看。同时重启 VRChat 客户端和 VRCX确认两边是同一个账号在线。还缺失就查日志中该好友的数据来源多数情况重新登录一次就能补全。截图元数据、自动启动、Discord 状态等功能异常截图没有存入世界信息 九成是照片不是 PNG 格式或保存目录没有写权限。确认只支持 PNG 格式的截图JPG 不会写入元数据。在设置 截图里把保存位置改成确定可写的目录默认路径最省事。历史照片可以在工具页用 ScreenshotMetadata 工具批量修复处理逻辑见 Dotnet/ScreenshotMetadata/。启动 VRChat 时自动启动的程序没触发多半是配了相对路径或者目标程序文件本身跑不起来。在设置 通用 自动启动应用里把程序改成绝对路径例如C:\Tools\OSC.exe。手动双击运行一次该程序确认没有被权限或安全软件拦截。启动快捷数据存放在%APPDATA%\VRCX\startup\配置异常时清空该目录重新配置模块实现在 Dotnet/AutoAppLaunchManager.cs。Discord Rich Presence 不更新先重启 VRCX系统休眠后 Discord 连接很容易悄悄断开。到 Discord 客户端检查活动隐私设置确认允许 VRCX 展示活动。如果还在用较旧版本存在协议不兼容的可能先升级到最新正式版仍有问题再翻日志。还是修不好如何正确反馈问题提交问题前把下面四样备齐维护者定位的速度会快很多版本号设置 通用里当前的 VRCX 版本注明是否 nightly 构建。系统信息操作系统及版本Windows 还是 Linux、是否经 Wine 运行。日志文件%APPDATA%\VRCX\logs\下最新的日志叠加层问题请附上VRCX.Overlay.log。复现步骤你做了哪些操作、期望结果、实际现象切勿贴出密码等敏感信息。求助渠道仓库内的 README/README.zh_CN.md 是官方中文文档官方 Wiki 还覆盖 Linux 部署、主题定制等专题在 VRCX 的官方 Issue 页面附上上述材料即可提交问题也可以从应用内设置 关于加入项目 Discord 服务器与社区直接交流。【免费下载链接】VRCXFriendship management tool for VRChat项目地址: https://gitcode.com/GitHub_Trending/vr/VRCX创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考