Maven POM变量插值疑问：为何可直接引用变量？何时省略全限定？

这个问题问得很到位，其实这是Maven处理属性的默认行为——所有在<properties>块中定义的自定义属性，都会被自动注入到全局属性上下文，所以你完全可以直接用变量名来引用，不需要加上project.properties.这个全限定前缀。

什么时候可以省略全限定路径？ #

总结下来主要有这几种场景：

• 自定义属性：你自己在POM的<properties>里定义的任何属性，比如示例中的mavenVersion，都可以直接用短名引用。Maven会自动把这些属性加入全局作用域，让你不用写冗长的全路径。
• Maven预定义的项目属性别名：一些核心的项目内置属性有官方的短别名，比如：
  • ${project.version} → 可以简写为 ${version}
  • ${project.basedir} → 可以简写为 ${basedir}
  • ${project.groupId} → 可以简写为 ${groupId}
    这些别名是Maven官方约定好的，用起来更简洁。
• 插件/扩展注册的全局属性：有些Maven插件或者扩展会把自己的属性注册到全局上下文，这种情况下也可以直接用短名引用（不过这种场景相对少见，具体要看插件文档）。

什么时候需要用全限定路径？ #

最主要的场景是解决命名冲突：如果你的自定义属性和Maven内置属性重名了，比如你定义了<version>1.0</version>，这时候${version}会优先匹配你的自定义属性，而如果你想引用项目本身的版本（也就是<project><version>中的值），就必须用${project.version}来明确区分。

再回到你的示例代码：

<project>
  ...
  <properties>
    <mavenVersion>2.1</mavenVersion> <!-- 变量定义处 -->
  </properties>
  <dependencies>
    <dependency>
      <groupId>org.apache.maven</groupId>
      <artifactId>maven-artifact</artifactId>
      <version>${mavenVersion}</version> <!-- 直接引用全局属性 -->
    </dependency>
    <dependency>
      <groupId>org.apache.maven</groupId>
      <artifactId>maven-project</artifactId>
      <version>${mavenVersion}</version> <!-- 同样直接引用 -->
    </dependency>
  </dependencies>
  ...
</project>

这里的mavenVersion因为是在<properties>里定义的，所以Maven自动把它放到了全局属性中，你直接写${mavenVersion}就能拿到值，完全没问题。

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