VS Code下Java项目遇PostgreSQL JDBC Driver未找到问题求助

针对你遇到的java.lang.ClassNotFoundException: org.postgresql.Driver或No suitable driver found错误，核心原因是驱动jar包未被正确加入项目类路径。结合VS Code 0.25.11版本的Java扩展，给出以下具体解决方案：

一、确认驱动版本兼容 #

先确保PostgreSQL驱动版本与你的Java版本匹配：

• Java 8 → 使用42.2.x系列驱动
• Java 11+ → 使用42.3.x及以上版本驱动

二、在VS Code中正确添加驱动 #

方法1：手动添加并配置类路径 #

1. 下载对应版本的postgresql-xxx.jar文件
2. 在项目根目录新建lib文件夹，将jar文件放入其中
3. 打开VS Code设置（快捷键Ctrl+,），搜索java.project.referencedLibraries，点击编辑 in settings.json
4. 在配置中添加lib目录下的所有jar包：

   "java.project.referencedLibraries": [
       "lib/**/*.jar"
   ]
   

5. 也可右键jar文件，直接选择Add to Java Build Path完成配置

方法2：用Maven管理依赖（推荐） #

如果项目是Maven结构，直接在pom.xml中添加依赖：

<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>postgresql</artifactId>
    <version>42.7.3</version> <!-- 替换为你匹配的版本 -->
</dependency>

VS Code会自动下载并加载该依赖，无需手动处理jar包。

三、代码优化（可选但推荐） #

从JDBC 4.2开始，DriverManager会自动加载类路径中的驱动，可删除Model构造方法里的Class.forName("org.postgresql.Driver")代码，避免不必要的异常。修改后的Model类：

//File: Model.java
import java.sql.*;

class Model {
    private final String url = "jdbc:postgresql://localhost:5432/Trabalho";
    private final String usr = "postgres";
    private final String pwd = "K1dN@m3dF1ng3r";

    protected Connection connect() {
        Connection con = null;

        try {
            con = DriverManager.getConnection(url,usr,pwd);
            System.out.println("Connected to the PostgreSQL server successfully!");
        } catch(SQLException ex) {
            System.out.println(ex.getMessage());
        }

        return con;
    }
}

四、验证步骤 #

1. 重启VS Code，让配置生效
2. 运行Control.java，检查是否能成功连接数据库

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