Infisical CLI 命令参数传递的正确方式

在使用 Infisical CLI 工具时，开发者可能会遇到一个常见问题：当尝试通过 CLI 传递参数给后续执行的命令时，系统会报出"unknown shorthand flag"错误。本文将详细解释这一问题的原因及解决方案。

问题现象

在 Next.js 项目中，开发者经常需要设置开发服务器的端口号。一个典型的 package.json 脚本配置可能如下：

"scripts": {
  "dev": "infisical run --env=dev next dev -p 3036"
}

当运行 bun dev 时，系统会报错：

Error: unknown shorthand flag: 'p' in -p

问题根源

这个问题的根本原因在于 CLI 参数解析的机制。Infisical CLI 会将所有以 - 开头的参数视为自身的参数选项，而不是传递给后续命令的参数。

解决方案

正确的做法是使用 -- 分隔符来明确区分 Infisical 自身的参数和要传递给后续命令的参数：

"scripts": {
  "dev": "infisical run --env=dev -- next dev -p 3036"
}

-- 是一个常见的 Unix/Linux 命令行约定，表示"此后的所有内容都应被视为位置参数而非选项"。

更简洁的写法

由于 dev 是 Infisical 的默认环境，命令可以进一步简化为：

"scripts": {
  "dev": "infisical run -- next dev -p 3036"
}

技术原理

1. CLI 参数解析规则：大多数命令行工具都遵循 POSIX 约定，将 - 开头的参数视为选项标志。

2. 分隔符的作用：-- 是一个标准的分隔符，告诉命令行解析器停止将后续内容解释为选项。

3. Infisical 的设计：Infisical CLI 采用这种设计是为了明确区分自身配置和要执行的命令参数，避免歧义。

最佳实践

1. 当使用 Infisical 包装其他命令时，总是使用 -- 分隔符
2. 对于常用环境，可以省略 --env 参数（dev 是默认值）
3. 在团队协作项目中，保持这种一致的写法可以提高可读性

总结

理解 CLI 工具的参数解析机制对于高效使用命令行工具至关重要。通过正确使用 -- 分隔符，开发者可以避免参数传递中的混淆问题，确保命令按预期执行。这种知识不仅适用于 Infisical，也适用于大多数 Unix/Linux 命令行工具。