install.sh --skip-aliases
文档中列出的别名参数，Shell 安装脚本并不接受。
antigravity.google/docs/cli/install 文档页面将 --skip-aliases 列为一个标志(flag),用于在安装时跳过对旧版 agy/antigravity shell 别名的清理。但实际部署在 antigravity.google/cli/install.sh 的引导脚本(239 行,已于 2026 年 7 月 27 日通过 curl 核实)并不认识这个标志:它的参数解析器只接受 -d/--dir(目标目录)和 -h/--help。任何其他参数,包括 --skip-aliases,都会落入 *) 兜底分支,产生 [ERROR] Unknown parameter: --skip-aliases 并随后以退出码 1 中止——这样一来安装根本不会发生。
此外:在脚本中搜索“alias”没有任何匹配结果。该脚本没有在任何地方修改 shell 别名;它只是下载并校验二进制文件,最后在内部调用 agy install(在 Windows 上是 agy.exe install)。因此文档中描述的该标志的作用,目前无论传入什么参数值都是无效的。
在 Windows 上情况有所不同:install.cmd 会把未知参数收集到 FORWARD_ARGS 中并附加到 SETUP_FLAGS 上,install.ps1 则通过 $passthroughArgs 做同样的事。因此在 Windows 上 --skip-aliases 不会导致中止,而是会被原样传递给 agy.exe install。至于该二进制文件之后是否会解析或忽略这个参数,从外部无法确认——能观察到的只是调用不会失败。
✅ 什么时候用？
在安装前自行检查该脚本目前实际支持哪些标志
curl -fsSL https://antigravity.google/cli/install.sh | bash -s -- --help
只使用脚本实际支持的标志来调整安装目标;之后自行在 shell 配置文件中检查并清理旧的别名
bash install.sh --dir ~/bin
⛔ 什么时候不该用？
在管道安装命令中加上 --skip-aliases,以为这样旧的别名就会被保留
该脚本只认识 -d/--dir 和 -h/--help;--skip-aliases 会落入 *) 兜底分支,输出“[ERROR] Unknown parameter: --skip-aliases”,并以退出码 1 中止,根本还没开始安装。
更好的选择: 不加这个标志运行脚本,或者事先自己用 --help 检查当前支持哪些参数
只依赖文档中对该标志的描述,而不去检查实际发布的脚本
文档页面仍然列出了 --skip-aliases,但 antigravity.google/cli/install.sh 实际发布的脚本并不支持它(截至 2026 年 7 月 27 日)。
更好的选择: 使用前自己通过 curl 和 --help 核实脚本,而不是盲目相信文档中的表格
来源
- Antigravity CLI 文档：Install ↗ antigravity.google