PowerShell中如何正确传入带特殊字符的Gradle -D系统参数

原有操作失败的核心原因 #

• 参数格式不满足Gradle解析规则：书写的-Djasypt.encrypt.password = $xyz!@在等号两侧添加了空格，Gradle参数解析器会将其拆分为三个独立片段（-Djasypt.encrypt.password、=、$xyz!@），无法识别为完整的系统属性配置
• PowerShell与CMD的特殊字符解析逻辑存在本质差异：参数值中的$是PowerShell的变量前缀符号，未加引号包裹时，PowerShell会优先将$xyz识别为内置变量做替换，实际传递给Gradle的参数值和预期内容完全不符
• 中转调用CMD的写法存在透传断层：直接拼接cmd /c执行时，PowerShell会先对整行命令做特殊字符解析和参数拆分，拆分后的不完整内容再传递给CMD，CMD拿到的命令本身缺少关键片段，无法正常执行

可直接使用的正确写法 #

稳定性最高、无额外转义成本的通用写法：将每一个独立的-Dkey=value参数整体用单引号包裹，全程保证等号两侧无空格：

gradle publish '-Djasypt.encrypt.password=$xyz!@'

单引号是PowerShell的纯字面字符串包裹符，引号内的所有字符（包括$、!、@）都会被原样透传给目标程序，不会触发任何变量替换、特殊字符解析逻辑。
如果需要通过CMD中转执行，正确写法为（确保PowerShell将完整命令块原样传递给CMD）：

cmd /c "gradle publish '-Djasypt.encrypt.password=$xyz!@'"

关键注意事项 #

• 无论在CMD还是PowerShell环境下，-D类参数必须严格遵循-Dkey=value格式，等号两侧绝对不能添加空格，否则必然会被参数解析器拆分为多段
• 只要参数值中包含$、空格、!、@、括号这类PowerShell语法特殊符号，优先用单引号将整个-D参数包裹，这是规避绝大多数PowerShell参数传值异常的通用方案
• 如果参数值本身需要包含单引号，可换用双引号包裹整个参数，此时需要对双引号内的$符号加反引号做转义（避免PowerShell自动解析变量），例如参数值包含$test时，双引号包裹的写法为"-Djasypt.encrypt.password=$test"`

内容的提问来源于stack exchange，提问作者amuru