在 Oracle 数据库的日常开发与管理工作中，PL/SQL Developer 以其强大的功能和便捷的操作，成为了众多开发者的首选集成开发环境（IDE），而所有高效工作的起点，便是成功建立一个与目标数据库的稳定连接，掌握如何在 PL/SQL Developer 中新建数据库连接，是每一位使用者必须迈出的第一步，本文将详细、清晰地介绍这一过程，并分享一些实用技巧,帮助您快速上手。
第一步：打开数据库连接窗口
启动 PL/SQL Developer 后，您会看到主界面，要新建连接，最直接的方式是点击工具栏上那个类似“插头”的图标（“Database”下拉菜单旁的按钮），您也可以通过菜单栏选择 文件 -> 新建 -> 数据库连接，或者使用快捷键 Ctrl+N，点击后，会弹出一个名为“选择数据库连接”的对话框,这里就是我们配置连接信息的核心区域。
第二步：配置连接参数
这个对话框中包含了连接数据库所需的所有关键信息，每个字段都至关重要，必须准确填写，为了更直观地理解,下表详细列出了各个参数的含义和配置方法：
| 参数名称 | 描述 | 配置示例 |
|---|---|---|
| 连接名称 | 为这个连接起一个易于识别的名称，方便日后区分和管理。 | 生产环境-财务系统、本地测试库 |
| 用户名 | 用于登录数据库的账户名。 | scott、hr、system |
| 密码 | 对应用户名的登录密码。 | tiger |
| 数据库 | 这是连接配置的核心，根据下方选择的“连接方式”，此处填写的内容不同。 | ORCL (TNS别名) 或 168.1.100:1521/ORCLPDB1 (直接连接) |
| 连接方式 | 决定了 PL/SQL Developer 如何解析“数据库”字段，通常有两种选择。 | TNS 或 直接 |
| 主机 | 当选择“直接”连接时，填写数据库服务器的 IP 地址或主机名。 | 168.1.100、db-server.mycompany.com |
| 端口 | 数据库监听器正在监听的端口号，Oracle 默认为 1521。 | 1521 |
| SID / 服务名 | 当选择“直接”连接时，需要指定数据库实例的标识符，现代 Oracle 环境推荐使用服务名。 | SID: ORCL；服务名: ORCLPDB1.localdomain |
连接方式详解：
- TNS 连接：这是最传统和常见的方式，它依赖于本地配置的
tnsnames.ora文件，该文件存储了数据库别名（即“数据库”字段中填写的内容）与具体网络地址（主机、端口、SID/服务名）的映射关系，使用 TNS 的好处是，当数据库地址变更时，只需修改tnsnames.ora文件，而无需逐个修改 PL/SQL Developer 中的连接配置。 - 直接连接：这种方式不依赖
tnsnames.ora文件，而是将所有网络信息直接在 PL/SQL Developer 中指定，格式通常为主机:端口/SID或主机:端口/服务名，它的优点是便携性强，换一台电脑只要知道连接信息就能立刻使用,无需额外配置文件。
第三步：测试并保存连接
在填写完所有信息后，强烈建议先点击“测试”按钮，PL/SQL Developer 会尝试使用您提供的参数连接数据库，如果连接成功，会弹出“连接成功”的提示框；如果失败，则会显示具体的错误代码和信息（如 ORA-12154 或 ORA-12541）,这为排查问题提供了关键线索。
测试通过后，点击“确定”或“保存”按钮，这个新的数据库连接就会出现在主界面的连接列表中，下次启动时，只需双击该连接，输入密码（如果未保存密码）,即可快速登录。
高效管理：连接的颜色与分组
为了进一步提升工作效率，PL/SQL Developer 提供了连接颜色编码功能，在连接配置窗口中，您可以点击“颜色”下拉框，为不同的连接设置不同的背景色，可以为生产环境设置醒目的红色，为测试环境设置安全的绿色，从而有效避免误操作，您还可以在连接列表中右键，选择“新建文件夹”，将不同项目或环境的连接进行分组管理,使界面更加整洁有序。
常见问题解答 (FAQs)
Q1: 提示“ORA-12154: TNS: 无法解析指定的连接标识符”是什么意思？如何解决？
A1: 这个错误通常在使用 TNS 连接方式时出现，它的意思是 PL/SQL Developer 无法根据您在“数据库”字段中填写的别名，在 tnsnames.ora 文件中找到对应的网络配置,解决方法如下：
- 检查 Oracle 主目录：在 PL/SQL Developer 中，进入
工具->首选项->Oracle->连接，查看“Oracle 主目录”和“OCI 库”的路径是否正确指向了您的 Oracle 客户端安装位置。 - 定位并检查
tnsnames.ora文件：该文件通常位于上述 Oracle 主目录下的network/admin文件夹内，打开文件，确认您使用的连接别名是否存在，并且其后的配置（HOST, PORT, SID/SERVICE_NAME）格式正确、没有拼写错误。 - 环境变量：检查系统环境变量
TNS_ADMIN是否设置，如果设置了，PL/SQL Developer 会优先从该变量指向的目录寻找tnsnames.ora文件。
Q2: 连接时出现“ORA-12541: TNS: 无监听程序”错误怎么办？
A2: 这个错误表明您的客户端已经成功解析了数据库地址（无论是通过 TNS 还是直接连接），但在目标服务器上，没有找到正在运行的数据库监听程序，或者监听程序没有在您指定的端口上监听,解决步骤如下：
- 确认服务器端监听状态：登录到数据库服务器，打开命令行工具，使用
lsnrctl status命令查看监听器的状态，如果显示“没有监听程序”，则使用lsnrctl start命令启动它。 - 检查防火墙：确保数据库服务器的防火墙允许来自您客户端 IP 地址的、通过指定端口（默认 1521）的访问请求。
- 核对连接信息：再次确认您在 PL/SQL Developer 中填写的“主机”地址和“端口”是否与服务器上监听器实际监听的地址和端口完全一致,有时监听器可能配置在非标准端口上。