插件安装失败主要因路径错误或未重启，需确保插件包格式为.hbxplugin、放入HBuilderX/plugins目录，并重启软件后启用；离线安装须解压含package.json的文件夹，且版本须兼容。
插件装不上，八成不是网络问题，而是没走对路径或没重启——HBuilderX 的插件机制对「重启」和「格式匹配」极其敏感，跳过这两步基本等于白装。
插件市场安装：搜不到、点不动、装完不生效
官方插件市场（https://ext.dcloud.net.cn/）是首选，但实际操作中常卡在三处：
- 搜索关键词要精准：
PHP Debug能搜到，php debug或php-debug可能漏掉；同理，CodeGeeX for HBuilderX必须全名输入，错一个字母或大小写就不显示 - 点击「安装」后没反应？先检查右下角状态栏有没有「正在下载」提示——没有的话，大概率是插件市场本身加载失败，可尝试快捷键
Ctrl+P（Windows）或Cmd+P（macOS），输入Extensions: Show Marketplace强制唤起 - 装完没图标、没功能？必须重启 HBuilderX，仅重载窗口或关闭再打开项目无效；重启后仍无反应，去「工具 → 插件安装 → 已安装」列表确认状态是否为「启用」
离线安装 .hbxplugin 文件：解压、放错目录、格式不对
离线安装不是把 zip 往里一扔就完事。HBuilderX 只认 .hbxplugin 后缀的包，且结构有硬性要求：
HBuilderX（Linux）
下载
HBuilderX 是由 DCloud 推出的一款轻量级前端开发工具，在 Linux 系统上主要用于 Web 开发与跨平台应用开发，尤其适合 Vue 和 uni-app 相关项目。
- 下载来源必须是
codegeex.cn/downloadGuide#hbuilder或ext.dcloud.net.cn提供的原生包；.vsix（VS Code 插件）、.zip（未打包成插件格式）直接丢进去会静默失败 - 正确路径是：
HBuilderX/plugins/（注意不是update/plugins/或根目录）；Windows 下典型路径为C:\HBuilderX\plugins\，macOS 为/Applications/HBuilderX.app/Contents/HBuilderX/plugins/ - 如果下载的是 zip，**必须先解压**，得到一个含
package.json的文件夹，再把整个文件夹拖进plugins目录；直接放 zip 文件进去，HBuilderX 完全无视
手动复制插件文件夹：依赖缺失、权限不足、版本不兼容
有些插件（比如内置浏览器、Vue Devtools）需多模块协同，手动复制时容易漏掉依赖：
- 打开插件包里的
package.json，看dependencies字段——例如"cef3"和"qrencode"是browser插件的硬依赖，缺一个，插件就显示「已安装」但功能不可用 - Windows 下若 HBuilderX 是以管理员身份运行，而
plugins目录权限受限，复制可能失败；建议右键「以管理员身份运行」HBuilderX 再试，或手动给plugins目录加写入权限 - 插件与 HBuilderX 版本强绑定：
CodeGeeX for HBuilderXv2.5.x 不支持 HBuilderX 4.4.0+，装了也报错Plugin activation failed；查插件页的「兼容版本」字段，别只看最新版
最常被忽略的一点：插件启用后，部分功能（如 CodeGeeX 的 Ctrl+Enter 补全）只在 .vue 或 .js 文件中生效，.html 或 .json 里按了也没反应——不是插件坏了，是作用域本来就没覆盖过去。
