-P传参需写为-Pkey=value（等号紧贴，无空格），值含空格或特殊字符时用单/双引号包裹；build.gradle中应使用project.findProperty('key')安全读取，-P具有最高优先级但需注意配置阶段延迟访问以避免失效。
gradle -P 传参时属性名和值怎么写
直接用 -Pkey=value 形式，中间不能有空格，等号必须紧贴。比如想传一个构建环境标识：gradle build -Penv=staging。如果值里含空格或特殊字符，要用单引号或双引号包裹：gradle build -Pmessage='hello world' 或 gradle build -Pversion="1.2.0-SNAPSHOT"。
常见错误是漏掉 = 或把空格当分隔符：gradle build -Penv staging 会被 Gradle 当作两个独立参数，env 属性根本不会被设置，也不会报错——只是静默失效。
build.gradle 里怎么读取 -P 传进来的属性
-P 设置的属性会作为 project property 直接挂载到 Project 实例上，所以可以直接用变量名访问（前提是没被同名 local 变量遮蔽）。
- 安全写法：用
project.findProperty('key')，返回Object或null，不会因属性不存在而抛MissingPropertyException - 简洁写法：直接写
key，但要求该 key 在当前作用域未被def key = ...声明过，否则会读到局部变量而非 project 属性 - 类型转换要自己做：比如
env.toString()或env as String，Gradle 不自动转类型
示例：
task printEnv <h3>-P 和 gradle.properties、ext 的优先级冲突怎么办</h3><p>命令行 <code>-P</code> 具有最高优先级，会覆盖 <code>gradle.properties</code> 文件里同名的属性，也会覆盖 <code>ext { key = ... }</code> 中定义的值。但要注意：</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/gongju/2870" title="Gradle 9.8.0"><img
src="https://img.php.cn/upload/manual/001/431/639/6ad9ce71d8cb6379.png" alt="Gradle 9.8.0" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/gongju/2870" title="Gradle 9.8.0" class="overflowclass">Gradle 9.8.0</a>
<p class="overflowclass"></p>
</div>
<a rel="nofollow" href="/xiazai/gongju/2870" title="Gradle 9.8.0" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
-
ext.key = 'from-ext'和-Pkey=from-cli同时存在时，key读出来是from-cli - 如果在
build.gradle里写了def key = 'local'，那无论-P怎么传，直接写key都会读到local—— 这不是优先级问题，是变量作用域遮蔽 - 想强制走 project 属性，就别用
def，统一用project.findProperty()或project.property('key')（后者在属性不存在时会抛异常）
为什么 -P 传的属性在某些 task 里读不到
最常踩的坑是：在 configure 块、afterEvaluate 之外的地方，过早访问了 -P 属性。Gradle 的 project property 是 lazy 初始化的，如果在配置阶段（configuration phase）就用 key.toString() 这种方式硬读，而此时 -P 尚未注入，就会触发默认值逻辑或空指针。
稳妥做法：
- 把对
-P属性的依赖延迟到 task 执行阶段（execution phase），比如放在doFirst或doLast闭包里 - 或者用
providers.gradleProperty('key')（Gradle 6.0+），它返回一个 lazy provider，真正用到时才解析 - 避免在
dependencies块里直接拼接-P值做动态版本号，除非你确认该属性一定存在且已就绪
复杂点在于：-P 属性看似简单，但它和 Gradle 的配置/执行两阶段模型深度耦合，不注意时机，值就“消失”了。
