gemini cli升级用npm install -g @google/gemini-cli@latest，android termux需加--build-from-source并设ndk变量；配置和历史不丢失，但升至0.23.0+后须手动开启preview features才能使用gemini 3。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在终端里用着Gemini CLI，突然发现提示“新版本可用”，但不确定该用哪个命令更新、要不要重装、会不会丢掉已有设置——这篇指南直接给出可立即执行的升级路径，不绕弯、不假设你已懂Node.js原理。
确认当前安装状态
先查清楚你装的是什么版本、怎么装的，避免误操作覆盖配置：
输入 gemini --version 查看当前运行版本；
再运行 npm list -g @google/gemini-cli 确认是否为 npm 全局安装；
【如果输出显示“empty”或报错 ENOENT】，说明未通过 npm 安装，后续所有 npm update 命令都无效，需先按官方方式重装。
标准升级：npm 全局包更新
适用于通过 npm install -g @google/gemini-cli 安装的用户：
方法一：一键拉取最新稳定版
执行 npm install -g @google/gemini-cli@latest
方法二：检查后再升级（更稳妥）
① 运行 npm outdated -g @google/gemini-cli → 查看是否有版本差异；
② 若显示当前版本低于 latest，则执行 npm install -g @google/gemini-cli@latest；
③ 升级完成后，必须重新运行 gemini --version 验证输出是否为新版本号——旧版本残留可能导致命令仍调用缓存二进制文件。
注意：此方式不会清除 ~/.gemini/ 下的配置、API密钥或历史会话，但【若从 0.22.x 升级到 0.23.0+，需手动启用预览功能才能使用 Gemini 3】，否则 /model 命令列表里看不到新模型。
Android Termux 用户专用升级流程
Termux 上的 Gemini CLI 含原生模块，不能跳过编译步骤，否则会报错“Cannot find module ‘…/build/Release/…’”：
第一步：重设 NDK 环境变量export android_ndk_path=$PREFIXexport npm_config_android_ndk_path=$PREFIX
第二步：强制源码编译安装npm install -g @google/gemini-cli@latest --build-from-source
这一步耗时较长（通常 3～8 分钟），期间不要中断 Termux；若卡在 “node-gyp rebuild” 阶段，大概率是 python 或 ndk-multilib 未安装，需先补全：pkg install python ndk-multilib。
启用 Gemini 3（升级后必做）
无论在哪种平台升级，只要目标是使用 Gemini 3 Pro 或 Gemini 3 Flash，就必须开启预览特性：
启动 CLI：gemini
进入设置：/settings
用方向键选中「Preview Features」→ 按回车 → 输入 true → 按 ESC 退出并保存；
最后执行 /model，此时列表中将出现 gemini-3-pro 和 gemini-3-flash 选项。
