故障排除指南
关于 Gemini CLI 常见问题和常见问题解答的解决方案。查找各种问题的快速修复和详细指导。
快速诊断命令
从这些命令开始诊断常见问题
gemini --version检查 CLI 版本和构建信息
gemini config list显示当前配置设置
gemini config reset重置配置为默认值
gemini logs查看最近的错误日志和调试信息
gemini doctor运行诊断检查和健康验证
gemini cache clear清除缓存数据和临时文件
常见问题和解决方案
按类别浏览以查找特定问题的解决方案
安装问题
安装和设置过程中的问题
npm install 因权限错误失败
使用带有 --global 标志的 npm 或配置 npm 使用不同的目录。在 macOS/Linux 上，您可能需要使用 sudo 或正确配置 npm。
解决方案：
npm install -g @google/generative-ai-cli安装后找不到命令
确保 npm 全局 bin 目录在您的 PATH 中。使用 `npm config get prefix` 检查并将 bin 目录添加到您的 PATH。
解决方案：
export PATH=$PATH:$(npm config get prefix)/binNode.js 版本兼容性问题
Gemini CLI 需要 Node.js 16 或更高版本。使用 nvm 更新 Node.js 或从 nodejs.org 下载。
解决方案：
node --version # Should be 16.0.0 or higher身份验证和 API 问题
API 密钥和身份验证问题
无效的 API 密钥错误
验证您的 API 密钥是否正确并具有适当的权限。如果需要，从 Google AI Studio 获取新密钥。
解决方案：
gemini config set api-key YOUR_API_KEYAPI 配额超出
在 Google AI Studio 中检查您的使用限制。考虑升级您的计划或实施速率限制。
解决方案：
gemini config set rate-limit 10 # Requests per minute网络连接问题
检查互联网连接和防火墙设置。如果在企业防火墙后面，请验证代理配置。
解决方案：
gemini config set proxy http://proxy.company.com:8080配置问题
CLI 配置和设置问题
配置文件损坏或丢失
将配置重置为默认值并重新配置。首先备份重要设置。
解决方案：
gemini config reset
gemini config set api-key YOUR_API_KEY模型不可用或已弃用
检查可用模型并更新配置。某些模型可能有地区限制。
解决方案：
gemini models list
gemini config set model gemini-pro环境变量未被识别
确保环境变量已正确设置和导出。检查变量名称和值。
解决方案：
export GEMINI_API_KEY=your_key_here
export GEMINI_MODEL=gemini-pro性能问题
响应缓慢和性能问题
响应时间慢
检查网络连接，减少请求大小，或尝试不同的模型。考虑对长响应使用流式传输。
解决方案：
gemini config set stream true
gemini config set max-tokens 1000内存使用率高
限制对话历史记录，减少批处理大小，或定期重启 CLI 会话。
解决方案：
gemini config set history-limit 10
gemini session clear超时错误
增加超时设置或将大请求分解为较小的块。
解决方案：
gemini config set timeout 60000 # 60 seconds工具和插件问题
工具和插件功能问题
工具执行失败
检查工具权限、文件路径和依赖项。验证工具是否已正确安装和配置。
解决方案：
gemini tools list
gemini tools test tool-name插件未加载
验证插件路径，检查语法错误，并确保安装了所有依赖项。
解决方案：
gemini plugins list
gemini plugins reload plugin-nameMCP 服务器连接问题
检查服务器状态、网络连接和协议版本兼容性。
解决方案：
gemini mcp status
gemini mcp reconnect server-name