Picocli 本身不会忽略美元符号，问题根源在于 Shell 对 $ 的变量展开行为；通过单引号包裹或反斜杠转义即可确保 $ 被原样传递给 Java 程序。

picocli 本身不会忽略美元符号，问题根源在于 shell 对 `$` 的变量展开行为；通过单引号包裹或反斜杠转义即可确保 `$` 被原样传递给 java 程序。

在使用 Picocli 构建命令行工具时，若需接收含特殊字符（如 $、*、! 等）的参数（例如密码），常遇到参数被意外截断或修改的问题。典型现象是：输入 "test23$34"，实际接收到的却是 "test234"——这并非 Picocli 或 Java 的解析错误，而是Shell（如 Bash/Zsh）在执行命令前已对 $34 进行了变量展开（尝试读取名为 34 的环境变量，该变量通常为空，故被替换为空字符串）。

✅ 正确做法：阻止 Shell 变量展开

方式一：使用单引号（推荐）

单引号内的所有字符均被 Shell 视为字面量，不进行任何展开：

java -jar encryption.jar passwd-enc -password 'test23$34' -key /usr/local/key.txt

方式二：转义美元符号

在双引号内，对 $ 添加反斜杠 \ 进行转义：

java -jar encryption.jar passwd-enc -password "test23\$34" -key /usr/local/key.txt

⚠️ 注意：不要写成 "test23\$34" 在 Windows PowerShell 中（其转义规则不同），建议统一优先使用单引号，兼容性更佳。

? 验证方法（快速排查）

在终端中直接测试 Shell 行为，确认是否为 Shell 层问题：

$ echo "test23$34"   # 输出：test234（因 $34 被展开为空）
$ echo 'test23$34'   # 输出：test23$34（字面量保留）
$ echo "test23\$34"  # 输出：test23$34（转义生效）

? 补充建议

• 避免在密码中依赖 Shell 解析：生产环境中，建议改用 --password-file 参数从文件读取密码，彻底规避命令行参数解析风险；
• Picocli 无需额外配置：只要参数完整抵达 JVM，Picocli 即可正常绑定（@Option 注解无须特殊处理 $）；
• 日志调试技巧：在 Picocli 命令类中打印原始参数值，例如：

  @Option(names = "-password", required = true) String password;
  // ... 在 run() 方法中添加：
  System.out.println("Received password: [" + password + "]");

总之，这不是 Picocli 的缺陷，而是 Unix/Linux Shell 的标准行为。掌握 Shell 字符引用规则，是构建健壮 CLI 工具的关键基础。