pl/sql developer 登录框无 tns 别名或报 ora-12154，主因是 tnsnames.ora 未被正确加载：文件须置于 32 位 oracle client 的 network\admin 目录下，编码为 ansi，别名语法严谨（如 orcl=(description=...），且需通过 tnsping 验证；同时确认 pl/sql developer 的 oracle home 与 oci library 均指向该 client 根目录，并重启软件生效。
PL/SQL Developer 登录框里看不到 TNS 别名，或者报 ORA-12154，根本不是数据库没开，而是 tnsnames.ora 没被正确加载或内容写错了。
tnsnames.ora 文件必须放在 Oracle Client 的 NETWORK\ADMIN 目录下
PL/SQL Developer 不自带连接能力，它靠 Oracle Client 提供的 oci.dll 工作，而这个 DLL 默认只在 TNS_ADMIN 环境变量指向的路径，或 Oracle Client 安装目录下的 NETWORK\ADMIN 里找 tnsnames.ora。你随便扔在桌面或 D:\config 下，它压根不会读。
- 确认你用的是 32 位 Oracle Client（因为 PL/SQL Developer 是 32 位），路径类似
C:\oracle\product\11.2.0\client_1\NETWORK\ADMIN - 不要手动创建新文件夹、复制文件到其他位置；解压或安装时保留原始层级，
NETWORK\ADMIN必须是子目录嵌套结构 - 如果改过
TNS_ADMIN环境变量，重启 PL/SQL Developer 才生效；不设该变量时，它会 fallback 到 Oracle Home 下的默认路径
tnsnames.ora 里别名定义不能有语法错误或空格陷阱
一个错位的括号、多一个空格、少一个右括号，都会让整个文件解析失败——但 Oracle 不报具体哪行错，只会统一给你 ORA-12154。
- 别名名（如
ORCL）后面不能有等号以外的空白，推荐紧贴写：ORCL=(DESCRIPTION=...，而不是ORCL = (DESCRIPTION = ... -
SERVICE_NAME必须和数据库实际一致（查SELECT value FROM v$parameter WHERE name = 'service_names';），不是 SID；11g 默认用 service_name，不是SID -
HOST填 IP 更可靠，填localhost有时因 hosts 解析或 IPv6 问题连不上；端口PORT必须和服务端listener.ora里一致（默认 1521） - 别名块之间至少空一行，避免被当作文本拼接
验证 tnsnames.ora 是否生效，别只靠 PL/SQL Developer 点登录
PL/SQL Developer 启动后才加载一次 tnsnames.ora，改完文件不重启软件，新别名不会出现；而且它不告诉你加载失败的具体原因。
- 用命令行跑
tnsping ORCL（把ORCL换成你的别名），返回OK (xx msec)才算真正通了 - 如果
tnsping报 “TNS-03505: Failed to resolve name”，说明文件路径不对或别名名写错了 - 如果
tnsping成功但 PL/SQL Developer 还是看不到，检查 PL/SQL Developer 的配置：Preferences → Oracle → Connection → Oracle Home 和 OCI Library 是否都指向那个 32 位 Client 的根目录
最常被忽略的一点：tnsnames.ora 的编码必须是 ANSI（Windows 记事本保存时选“ANSI”，不是 UTF-8 或 Unicode），否则某些版本的 oci.dll 会静默跳过整个文件。
