Gemini CLI 装不上 / 命令找不到
Gemini CLI 安装与 PATH 配置的排查。，附原因排序、修复步骤与责任判定。
更新 2026-10-28
核验 2026-10-28 · 码农阿风
gemini-cli安装
30 秒结论
Node 版本不够或全局 bin 不在 PATH。
报错原文对照
command not found: gemini
npm ERR! engine原因排序
| 概率 | 原因 |
|---|---|
| 50% | Node 版本低 |
| 35% | PATH 没有全局 bin |
| 15% | 权限问题 |
修法
先在自己这边查
- Node 升到 20+
- 把 npm prefix 的 bin 加进 PATH
- 避免 sudo 安装
再往服务方查
这一项不是你这边能解决的。
责任判定表
| 现象 | 责任方 |
|---|---|
| command not found | PATH |
| 装了报错 | Node 版本 |
| 权限错 | npm prefix |
什么时候该换
和 Claude Code 的安装问题几乎一样，处理方式通用。
你在这个站点上遇到过这个问题？
认领站点后可补充证据、申请公开核验；认证不改榜单排序，只对应可复核的检测与复测。
认领 / 申请认证