直接回答：插件显示无法读取，多数是三类原因——文件夹层级放错导致客户端识别不到、.toc 里写的版本号与当前客户端不匹配、或者插件依赖的库没装。这三种的处理方式不同，先看表现再动手。
水豚乐园官网地址：https://capycraft.io/
玩外服游戏推荐用光年加速器：https://www.gnjiasu.com/
外服玩家交流QQ群：725189859 进群送加速器月卡
| 表现 | 原因 | 修复 |
|---|---|---|
| 插件列表里根本没有该插件 | 目录层级错误 | 调整到 AddOns 下第一层 |
| 显示"过期"或"不兼容" | .toc 版本号不匹配 | 更新插件或按说明处理 |
| 勾选后功能不出现 | 缺少依赖库或模块 | 补装依赖插件 |
| 进游戏报 Lua 错误 | 插件冲突或配置损坏 | 逐个启停，重置配置 |
打开客户端目录下的 Interface\AddOns，正常的结构应该是 AddOns\插件名\插件文件与 .toc。如果看到的是 AddOns\插件名\插件名\...，就把里层文件夹整体上移一层。这是最常见也最容易忽略的问题。
用记事本打开插件文件夹里的 .toc 文件，里面有 Interface 版本号。版本号与当前客户端不一致时，客户端会标记为过期。处理方式有两种：从插件来源处拿对应版本，或按来源说明修改版本号（前提是你确认插件功能本身兼容，否则会出现隐性错误）。
很多插件依赖公共库（如框架库、计时库）。只装主插件不装库，功能就不会出现。解决办法是看插件说明里列出的依赖项，把它们一起装到 AddOns 下。
把所有插件禁用，只启用一个，逐个加回来。出现问题的那个就是冲突源。定位后可以找替代插件，或者调整两者的加载顺序。配置损坏时，删掉 WTF 里对应插件的配置文件让它重新生成，通常能解决。
Q1：改 .toc 版本号安全吗？
有的插件能正常用，有的会静默出错。不确定就找对应版本，别图省事。
Q2：修复后按键和界面乱了？
重置配置会丢自定义布局，重配前先备份 WTF 文件夹。
Q3：多个插件包同时装会冲突吗？
会。尤其界面类插件，建议只保留一套主框架。
Q4：插件报错会不会封号？
普通 Lua 报错不会，但自动化操作类插件会。插件选择原则见 本站资讯栏目。
插件读取失败按"层级 → 版本 → 依赖 → 冲突"四步走，绝大多数问题在前两步就能解决。改任何文件前先备份，这是最省事的习惯。客户端版本与官网不一致时，回 capycraft.io 下载页核对版本号。