PL/SQL Developer 连接 Oracle 失败主因是位数不匹配、OCI 路径配置错误或 tnsnames.ora 未生效；需确保 PL/SQL 与 Instant Client 位数一致，正确设置 Oracle Home、OCI library 路径及 TNS_ADMIN 环境变量，并验证 NLS_LANG 与服务端字符集匹配。
PL/SQL Developer 本身不带 Oracle 客户端能力，必须靠 Instant Client 提供 oci.dll 才能连库。绝大多数连接失败，不是账号密码错，而是位数不匹配、路径没配对、或 tnsnames.ora 根本没生效。
确认 PL/SQL Developer 和 Instant Client 的位数是否一致
这是最常踩的坑：32 位 PL/SQL Developer 加载不了 64 位 oci.dll，反之亦然。报错典型是 Could not load oci.dll 或直接闪退。
- 查 PL/SQL Developer 位数：右键快捷方式 → 属性 → “兼容性”页签里看有没有勾选“以兼容模式运行”，但更准的是用
tasklist /fi "imagename eq plsqldev.exe"，如果显示plsqldev.exe且没有*32后缀，大概率是 64 位；带*32就是 32 位 - 查
Instant Client位数：解压包名里通常含win-x86（32 位）或win-x64（64 位）；也可用file命令或 Dependency Walker 打开oci.dll看 Machine 字段 - 下载时务必去 Oracle 官网对应页面，比如 32 位就选
Microsoft Windows (32-bit)下的Basic Package，别混用Basic Light——它缺oci.dll
设置 Oracle Home 和 OCI library 路径（PL/SQL 内部配置）
这个配置在 PL/SQL Developer 启动后才生效，不能靠环境变量替代。即使你设了 ORACLE_HOME，PL/SQL 也不认——它只读自己界面里填的值。
- 打开 PL/SQL Developer（哪怕连不上），进
Tools → Preferences → Oracle → Connection -
Oracle Home填到Instant Client解压后的根目录，比如D:\instantclient_21_9，不要带子目录 -
OCI library必须精确指向oci.dll文件，比如D:\instantclient_21_9\oci.dll，路径错一个字符就报Could not locate oci.dll - 改完必须重启 PL/SQL Developer，否则不加载新路径
让 tnsnames.ora 生效的三个必要条件
tnsnames.ora 不是放哪都行，PL/SQL Developer 只在特定条件下才读它。常见现象是输对了连接名却提示 ORA-12154: TNS:could not resolve the connect identifier。
- 文件必须放在
network\admin子目录下，完整路径类似D:\instantclient_21_9\network\admin\tnsnames.ora；network和admin目录要手动建，不能少 - 必须设置系统环境变量
TNS_ADMIN，值就是上面那个admin目录的绝对路径，比如D:\instantclient_21_9\network\admin -
tnsnames.ora里别用中文注释，也别加 BOM 头；每条记录结尾不能有多余空格或换行；SERVICE_NAME或SID要和数据库实际一致（可用SELECT value FROM v$parameter WHERE name = 'service_names'确认）
中文乱码和 NLS_LANG 的实际影响
NLS_LANG 不只是“让中文不乱码”那么简单，它直接影响字符集转换逻辑。设错会导致插入数据变问号、查询结果截断、甚至 ORA-12705 错误。
- 值格式必须是
LANGUAGE_TERRITORY.CHARACTERSET，比如AMERICAN_AMERICA.AL32UTF8（服务端是 UTF8）或AMERICAN_AMERICA.ZHS16GBK（服务端是 GBK） - 不要盲目抄网上示例；先查服务端：连上数据库后执行
SELECT parameter, value FROM nls_database_parameters WHERE parameter IN ('NLS_CHARACTERSET', 'NLS_NCHAR_CHARACTERSET') -
NLS_LANG是系统级环境变量，设完需重启 PL/SQL Developer，且不能只在命令行里临时 set —— 那样对图形界面进程无效
真正卡住人的往往不是某一步做错了，而是多个小配置环环相扣：位数对了但 TNS_ADMIN 没设，tnsnames.ora 放对了但 NLS_LANG 导致连接被拒绝。建议每配一项就验证一次依赖项，比如配完 OCI 路径，先确认能不能进登录框；配完 TNS_ADMIN，再试连接名解析；最后调 NLS_LANG。顺序乱了，排查成本会指数级上升。
