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