Gradle如何在不清除Property已设值时获取其convention默认值

我需要实现一个在常规编程语言中非常基础的功能：获取Property的默认值（即convention约定值）。Gradle官方文档在《Lazy configuration（惰性配置）》章节中介绍了为Property设置convention的方法，示例代码如下：

def property = objects.property(String)

// Set a convention
property.convention("convention 1")
println("value = " + property.get())

// Can replace the convention
property.convention("convention 2")
println("value = " + property.get())

property.set("value")

// Once a value is set, the convention is ignored
property.convention("ignored convention")
println("value = " + property.get())

上述示例演示了convention的生效逻辑：

• 未设置显式值时调用get()会返回convention值
• 未设置显式值时可替换convention
• 一旦设置了显式值，后续配置的convention会被忽略

目前存在一个问题：当Property已经设置了显式值后，没有公开的API可以直接查询其绑定的convention默认值。目前已知的唯一获取方式是先将Property的值清空（置为null）再调用get()获取，对应代码如下：

property.value(null).get()

但这种方式需要执行多余的修改操作，毕竟convention值本身是存储在Property对象内部的，这种实现方式并不合理。问题核心是：是否存在无需清空Property已设置的显式值，就能直接获取其convention默认值的方法？

结论很明确：Gradle 没有提供公开的稳定API来直接读取已设置显式值的Property的convention值，这是官方刻意做的API设计，不是功能遗漏。

你提到的置空再取值的方案强烈不建议使用：这个操作会真实清除Property上已绑定的显式值，还会触发所有关联到该Property的变更监听器，很容易引入难以排查的配置错误。

如果确实需要获取convention值，只有两个可行方案：

• 反射读取内部字段：Gradle的Property实现类（不同版本实现类、字段名存在差异，常见实现类为DefaultProperty）会单独存储convention值的引用，你可以通过反射直接读取对应字段，不需要修改Property本身的显式值。注意这种方式依赖Gradle内部实现，版本升级后可能失效，需要自行做版本兼容处理。
• 自行托管convention值：这是零兼容风险的最优方案。在你调用property.convention(xxx)为Property设置约定值时，同步把这个默认值存储到自定义的变量中，后续需要读取convention值时直接访问自己维护的变量即可，完全不需要操作Property实例本身。

不要浪费时间寻找其他公开API，目前所有稳定版本的Gradle都没有开放这个能力。

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