插件安装失败90%是windows权限问题而非网络问题，日志出现“cannot open writeonly”或“拒绝访问”错误即表明hbuilder x因uac限制无法向program files目录写入临时文件，需以管理员身份运行程序或更改安装路径至非受保护目录。
插件安装失败，90%不是网络问题，而是权限或路径写入被拦住——尤其在 Windows 的 Program Files 下安装时。
插件安装卡住或报“拒绝访问”，先看日志里有没有 cannot open WriteOnly
这个错误几乎锁定是 Windows 权限问题。HBuilder X 默认装在 D:\Program Files\HBuilderX，而系统禁止普通权限程序往 Program Files 写文件（包括创建 update/plugins/ 临时 ZIP）。日志里出现 "拒绝访问。" 或 EPERM（比如 npm ERR! syscall mkdir），基本不用查网络，直接跳到权限环节。
- 右键 HBuilder X 快捷方式 → 选“以管理员身份运行”，再点安装
- 别只双击图标启动——UAC 不触发，权限就始终不够
- 如果用命令行启动（如
hb.exe），也得用管理员权限的 CMD 或 PowerShell
插件市场打不开、提示“网络错误”，重点查代理和 hosts
真网络不通时，日志里通常有 QUrl("http://... 失败、timeout 或 SSL handshake failed。但更常见的是被公司代理或 DNS 拦截，尤其是访问 dcloud.io 域名。
HBuilderX（Linux）
下载
HBuilderX 是由 DCloud 推出的一款轻量级前端开发工具，在 Linux 系统上主要用于 Web 开发与跨平台应用开发，尤其适合 Vue 和 uni-app 相关项目。
- 打开 HBuilder X 设置 → “常规” → 检查 HTTP/HTTPS 代理是否误开（企业网常用 PAC）
- 用浏览器手动访问
https://update.dcloud.net.cn/hbuilderx/plugins/，看能否加载 JSON 列表 - 若打不开，尝试改
hosts：加一行114.114.114.114 update.dcloud.net.cn（用国内可解析 IP） - 杀毒软件（如 360、火绒）常静默拦截 Electron 网络请求，临时禁用试试
npm ERR! code EPERM 出现在插件依赖安装时，说明 Node.js 缓存目录权限不对
这类错误多见于编译类插件（如 compile-less、typescript-server），它们会调用本地 npm 安装依赖。错误路径指向 node_cache\_cacache，说明 Node.js 缓存目录没写权限。
- 不要把 Node.js 装在
Program Files—— 改装到C:\nodejs这类无保护路径 - 运行
npm config get cache确认当前缓存位置，再用管理员权限给该目录赋写入权（右键 → 属性 → 安全 → 编辑） - 或者重设缓存路径：
npm config set cache "C:\Users\用户名\node_cache"
手动离线安装是最稳的兜底方案，关键要放对目录
从日志里复制插件下载 URL（如 builtincef3browser.1.2.0.zip），浏览器下载后不能随便解压——路径和结构必须严格匹配。
- 把 ZIP 文件直接丢进
HBuilderX\update\plugins\目录（不是plugins\！） - 确保文件名带版本号，且不重命名（HBuilder X 会按名识别并自动解压）
- 重启 HBuilder X，它会在下次启动时自动检测并安装该 ZIP
- 如果
update\plugins\目录不存在，手动创建——但要注意父目录权限继承问题
最易被忽略的点：权限问题不是“一次提权就万事大吉”。HBuilder X 升级后可能重建目录结构，旧权限失效；插件更新也会重新触发写操作。只要它还装在 Program Files，就得持续面对 UAC 和目录继承的双重限制。
