Picocli 本身不会忽略美元符，问题根源在于 Shell 对 $ 的变量展开行为；通过单引号包裹或反斜杠转义即可确保 $ 字符原样传递给 Java 应用。
picocli 本身不会忽略美元符，问题根源在于 shell 对 `$` 的变量展开行为；通过单引号包裹或反斜杠转义即可确保 `$` 字符原样传递给 java 应用。
在使用 Picocli 构建命令行工具（如密码加密工具）时，若用户输入的密码包含 $ 符号（例如 "test23$34"），实际传入程序的字符串可能变为 "test234"——这并非 Picocli 或 Java 的解析问题，而是Shell 层面的变量扩展（variable expansion）导致的。
Bash、Zsh 等主流 Shell 会将未加保护的 $ 视为变量引用前缀。当执行：
java -jar encryption.jar passwd-enc -password "test23$34" -key /user/local/key.txt
Shell 会尝试展开 $34（一个不存在的变量），结果为空，最终等效于传递 "test23" + "" → "test23"，若 $34 恰好被误认为位置参数（极少发生），也可能引发不可预期行为。可通过以下命令快速验证：
$ echo "test23$34" test234
✅ 正确解决方案（任选其一）：
-
推荐：使用单引号包裹（最安全，禁用所有 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
⚠️ 注意事项：
- 双引号 "..." 仅禁用部分 Shell 元字符（如空格、通配符），但不禁止 $、` 和 的特殊含义；
- Windows CMD/PowerShell 行为不同（CMD 中 $ 无特殊意义，PowerShell 则类似 Bash），跨平台部署时建议统一采用单引号方案或在文档中明确说明；
- Picocli 本身完全信任 args 数组内容——它接收的是 Shell 解析后的最终字符串，因此无需修改 Picocli 配置或注解；
- 若密码由脚本动态生成，务必使用 printf '%q' "$password"（Bash）或 echo "$password" | sed 's/$/\$/g' 等方式安全转义。
总结：这不是 Picocli 的缺陷，而是 Shell 的标准行为。掌握 Shell 引号规则是构建健壮 CLI 工具的基础前提。始终优先用单引号传递含 $、、*、? 等特殊字符的参数，可避免绝大多数意外截断或注入问题。
