在VSCode中使用Maven添加依赖时提示「[module name]无法解析为模块」

核心原因 #

你使用了Java模块系统（module-info.java），所有要在代码中调用的依赖，必须在module-info.java里通过requires声明对应模块名——注意模块名≠Maven的artifactId，很多依赖的模块名和artifactId不同，比如gson的模块名是com.google.gson，不是gson。

具体解决步骤 #

1. 修正module-info.java #

在模块声明中添加对gson模块的引用：

module com.example {
    requires javafx.controls;
    requires javafx.fxml;
    // 新增这一行声明gson模块
    requires com.google.gson;

    opens com.example.controllers to javafx.fxml;

    exports com.example;
    exports com.example.controllers; 
}

2. 刷新VSCode的Maven与Java服务 #

• 打开VSCode的Maven面板，点击「Reload All Maven Projects」
• 按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），输入「Java: Clean Java Language Server Workspace」执行，随后重启VSCode

3. 版本一致性检查 #

你的pom.xml中Java版本配置为11，但JavaFX使用的是13版本，虽然能运行，但建议尽量保持版本统一（比如都用11或都用13），避免潜在兼容性问题。

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