必须同时设置path和oci_lib64环境变量，仅设其一将导致ora-12154等连接失败；path与oci_lib64均需指向instant client解压根目录（如c:\instantclient_19_22），tns_admin须设为wallet或tnsnames.ora所在绝对路径，并安装匹配版本的visual c++运行库。
PATH 和 OCI_LIB64 环境变量必须同时设置
只加 PATH 不行，只设 OCI_LIB64 也不行。Windows 下很多工具（比如 PL/SQL Developer、sqlplus、Python 的 oracledb Thick 模式）会按不同顺序查找 Oracle 库：有的先查 OCI_LIB64，有的依赖 PATH 中的 oci.dll 位置，还有的两者都用。漏掉任意一个，就会报 ORA-12154、OCIError: unable to load OCI DLL 或直接闪退。
-
PATH值设为 Instant Client 解压后的完整路径，例如：C:\instantclient_19_22 -
OCI_LIB64必须也设成同样路径（注意不是bin子目录） - 如果用的是 32 位程序（如旧版 PL/SQL Developer），要配
OCI_LIB32，而不是OCI_LIB64 - 改完环境变量后，重启所有已打开的命令行或 IDE，否则不生效
TNS_ADMIN 必须指向 wallet 或 tnsnames.ora 所在目录
Oracle Instant Client 默认不读当前目录下的 tnsnames.ora，也不会自动解压 wallet 后就认它。必须显式设置 TNS_ADMIN 环境变量，值为包含 tnsnames.ora 或自治数据库 wallet 解压后全部文件（cwallet.sso、sqlnet.ora、tnsnames.ora）的**完整绝对路径**。
- 不能写相对路径，不能写
~或%USERPROFILE% - wallet 解压后，需手动编辑
sqlnet.ora，把其中的(DIRECTORY="?/network/admin")替换为该目录的绝对路径，例如：(DIRECTORY="C:\adb_wallet") - 若同时存在
tnsnames.ora和 wallet，TNS_ADMIN指向 wallet 目录即可，Instant Client 会优先用 wallet 里的连接信息
版本匹配和 Visual C++ 运行库缺一不可
Instant Client 不是“下载解压就能用”。19c 客户端连 12c 数据库没问题，但反过来不行；更关键的是，每个版本硬性依赖特定版本的 Microsoft Visual C++ Redistributable。
- Instant Client 19.x → 要求
Microsoft Visual C++ 2019 Redistributable（x64） - Instant Client 12.1 → 要求
Microsoft Visual C++ 2010 Redistributable（x64） - 没装对应运行库，启动
sqlplus会直接弹窗报错：“无法启动此程序，因为计算机中丢失 VCRUNTIME140.dll” 或类似提示 - 不要试图用旧版运行库凑合——哪怕只差一个小版本号，
oci.dll加载也会失败
PL/SQL Developer 或 Navicat 需单独指定 OCI 库路径
这类 GUI 工具不完全信任系统环境变量，尤其在多版本共存时容易选错 oci.dll。即使 PATH 和 OCI_LIB64 都对，仍可能连不上。
- PL/SQL Developer：进入
Tools → Preferences → Oracle → Connection，手动填Oracle Home（即 Instant Client 根目录）和OCILibrary（必须是完整路径，例如：C:\instantclient_19_22\oci.dll） - Navicat：连接配置里找 “Advanced” 或 “Driver Settings”，明确指定 OCI library path
- 如果机器上装过完整 Oracle Client，务必确认没被注册表残留干扰——Instant Client 最好用纯净目录，避免混放
TNS_ADMIN 路径写错、Visual C++ 运行库没装、或者 GUI 工具绕过环境变量硬指定路径这三个地方。其他配置出错通常有明确报错，而这三处失败时可能只显示“连接超时”或“用户名密码错误”，让人误判问题根源。
