gemini : 无法将gemini项识别为 cmdlet、函数、脚本文件或可运行程序的名称 解决方案问题描述在通过 npm 全局安装 Gemini CLI 后终端运行gemini命令时出现gemini : 无法将gemini项识别为 cmdlet、函数、脚本文件或可运行程序的名称。 请检查名称的拼写如果包括路径请确保路径正确然后再试一次。完整报错环境通常发生在以下场景Windows PowerShell / CMD 中执行gemini命令刚通过npm install -g anthropic-ai/gemini-cli或npm install -g google/gemini-cli安装npm 显示安装成功但命令无法识别npx gemini可以正常运行但直接打gemini不行原因分析这个错误和 OpenClaw / OpenCode / Codex 的同类错误几乎完全一致根因都是npm 全局安装目录不在系统 PATH 环境变量中。在 Windows 上npm 包的可执行文件放在C:\Users\你的用户名\AppData\Roaming\npm\这个目录默认可能不在 PATH 中导致终端找不到gemini.cmd脚本。另外还有一个特殊原因Gemini CLI 的包名和命令名不一致。早期 Gemini CLI 的包名是google/gemini-cli但命令名可能是gemini或gemini-cli需要确认实际安装的命令名。解决方案方案一确认命令名并添加 PATH# 1. 查看 npm 全局目录下有什么可执行文件 ls $(npm config get prefix)\gemini* # 输出可能是 # gemini.cmd ← 命令名是 gemini # gemini-cli.cmd ← 命令名是 gemini-cli # 2. 根据实际文件名执行 gemini # 如果上面找到 gemini.cmd gemini-cli # 如果上面找到 gemini-cli.cmd方案二添加 npm 全局路径到 PATH# 管理员模式 PowerShell $npmPath npm config get prefix [Environment]::SetEnvironmentVariable( Path, [Environment]::GetEnvironmentVariable(Path, User) ;$npmPath, User ) # 重启终端后重试方案三重新安装到系统全局路径# 使用系统全局路径安装需要管理员权限 npm install -g google/gemini-cli --prefix /usr/local # 或 macOS / Linux sudo npm install -g google/gemini-cli方案四使用 npx 调用npx google/gemini-cli # 或 npx gemini-cli方案五创建 PowerShell AliasWindows 快捷方式# 编辑 PowerShell Profile notepad $PROFILE # 在文件末尾添加 function gemini { $(npm config get prefix)\gemini.cmd args } # 保存后重新加载 . $PROFILE总结gemini命令无法识别的根本原因和所有 npm 全局 CLI 工具一样npm bin 目录不在 PATH 中。另外特别提醒注意包名和命令名可能不同用ls $(npm config get prefix)\gemini*确认实际的命令名是什么。