Picocli 本身不会忽略美元符号，问题根源在于 Shell 对 $ 的变量展开行为；解决方法是使用单引号包裹参数或对 $ 进行反斜杠转义，确保字符串原样传递给 Java 应用。
picocli 本身不会忽略美元符号，问题根源在于 shell 对 `$` 的变量展开行为；解决方法是使用单引号包裹参数或对 `$` 进行反斜杠转义，确保字符串原样传递给 java 应用。
在使用 Picocli 构建命令行工具时，若需传递包含特殊字符（如 $、*、! 等）的参数（例如加密密码），常出现参数“丢失”或“被篡改”的现象。但需明确：Picocli 和 Java 运行时本身完全不解析或修改命令行参数内容——真正截获并处理 $ 符号的是外部 Shell（如 Bash、Zsh）。
以问题中的命令为例：
java -jar encryption.jar passwd-enc -password "test23$34" -key /user/local/key.txt
Shell 在执行前会将 "test23$34" 解析为：$34 被视为一个空的环境变量（因无名为 34 的变量），因此整个字符串被替换为 "test23" + 空值 + "" → 最终传给 JVM 的实际参数是 test234（注意：$34 中的 34 并非变量名，Bash 实际按 $3 + 4 解析，而 $3 通常为空，故结果为 test234）。可通过以下命令快速验证：
echo "test23$34" # 输出：test234（Shell 展开所致） echo 'test23$34' # 输出：test23$34（单引号禁用展开） echo "test23\$34" # 输出：test23$34（反斜杠转义）
✅ 正确做法（任选其一）：
-
推荐：使用单引号（最安全，禁用所有 Shell 特殊字符解析）
java -jar encryption.jar passwd-enc -password 'test23$34' -key /user/local/key.txt
-
次选：转义美元符（适用于需在双引号内保留其他变量的场景）
java -jar encryption.jar passwd-enc -password "test23\$34" -key /user/local/key.txt
⚠️ 注意事项：
- Windows PowerShell 或 CMD 行为不同（PowerShell 中 $ 同样需转义或引用），建议统一使用单引号（PowerShell 支持）或反引号（`）转义；
- 不要依赖 Picocli 的 @| 或 arity 等注解来“修复”该问题——它无法干预 Shell 层面的参数预处理；
- 若通过脚本调用，务必检查脚本中变量插值逻辑，避免二次展开（例如 "$PASS" 应改为 '$PASS' 或 "$PASS" 配合 set -f 关闭通配）；
- 开发阶段可在 Picocli 的 @Command 类中添加调试输出，确认 args 数组首项是否已失真，从而快速定位问题层级。
总结：这不是 Picocli 的 Bug，而是 Shell 元字符处理的通用机制。掌握引号规则与转义语法，是构建健壮 CLI 工具的基础能力。
