Maven 默认不会用命令行 -D 参数覆盖 pom.xml 中硬编码的 值；要支持覆盖，必须将配置项绑定到可被外部重写的 Maven 属性（如 ${sourcePath}），而非直接写死值。

maven 默认不会用命令行 `-d` 参数覆盖 `pom.xml` 中硬编码的 `` 值；要支持覆盖，必须将配置项绑定到可被外部重写的 maven 属性（如 `${sourcepath}`），而非直接写死值。

在 Maven 构建生命周期中，插件配置（）的解析发生在项目模型（POM）加载阶段，此时所有表达式（如 ${project.basedir}）会被立即求值并固化为字符串常量。这意味着：

• 若 pom.xml 中直接写 C:/src/main/java/ 或 ${project.basedir}/src/main/java/，该值在插件执行前就已确定，命令行 -DsourcePath=... 将被完全忽略；
• 只有当配置项显式引用一个未在 POM 中定义的属性占位符（如 ${sourcePath}）时，Maven 才会在运行时尝试从命令行、settings.xml 或 pom.xml 的 中查找该属性值，并按 Maven 属性优先级规则 进行解析（命令行 -D 优先级最高）。

✅ 正确做法：在 pom.xml 中通过 定义默认值，并在 中引用该属性：

<properties><!-- 可被命令行 -DsourcePath 覆盖 --><sourcepath>${project.basedir}/src/main/java/com/core/</sourcepath><!-- 可被命令行 -DoutputPath 覆盖 --><outputpath>C:/Projects</outputpath></properties><plugin><groupid>com.directory.maven.plugins</groupid><artifactid>javadoc-generator-maven-plugin</artifactid><version>1.2.0-SNAPSHOT</version><configuration><sourcepath>${sourcePath}</sourcepath><outputpath>${outputPath}</outputpath></configuration><executions><execution><goals><goal>javadoc</goal></goals></execution></executions></plugin>

这样，执行以下命令即可成功覆盖配置：

mvn javadoc-generator:javadoc \
  -DsourcePath="C:/Projects/my_project/src/main/java/com/core/" \
  -DoutputPath="C:/Projects/tmp"

⚠️ 注意事项：

• 不要混用同名属性与插件 @Parameter(property = "xxx") 中的 property 名——这是推荐做法（如本例中 @Parameter(property = "sourcePath") 与 ${sourcePath} 保持一致），能确保语义清晰且兼容性最佳；
• 若插件代码中 @Parameter 的 property 名与 POM 中属性名不一致（如 property = "mySource" 但 POM 写 ${sourcePath}），则覆盖失效；
• defaultValue（如 @Parameter(defaultValue = ".")）仅在 POM 中完全未配置该参数且命令行也未提供 -D 时生效，它不参与属性覆盖逻辑。

总结：Maven 插件参数的“可覆盖性”取决于 POM 配置是否采用属性占位符形式。将默认值移至 并在 中引用，是兼顾默认行为与灵活覆盖的标准实践。