如何配置OracleInstantClient环境变量？

Instant Client 配置失败主因是路径错误、位数不匹配或环境变量设错；需确保 sqlplus.exe 与 oci.dll 同目录、PATH 指向解压根目录、TNS_ADMIN 正确指向 networkadmin、PL/SQL Developer 位数与 Instant Client 一致。

sqlplus /nolog 报“不是内部或外部命令”，基本就是 PATH 没配对；PL/SQL Developer 提示“Could not initialize oci.dll”，八成是位数不匹配或 TNS_ADMIN 指向错误。Instant Client 是 ZIP 免安装包，环境变量配置错一个环节，整个链路就断了。

PATH 必须指向解压根目录，且 sqlplus.exe 与 oci.dll 平级

Instant Client 不是传统安装程序，它靠系统 PATH 找到核心 DLL 和可执行文件。关键前提是：sqlplus.exe、oci.dll、oraocci23.dll（版本号随包变化）必须在同一个目录下——不能有嵌套子文件夹。

1. 下载 instantclient-basic-windows.x64-*.zip 和 instantclient-sqlplus-windows.x64-*.zip 两个包
2. 新建纯英文、无空格、无括号路径（如 E:oracleinstantclient_23_6）
3. 把两个 ZIP **全部直接解压到该路径**（不是各自解压出 instantclient_23_6 子目录）
4. 确认该目录下能看到 sqlplus.exe 和 oci.dll 等文件平级存在
5. 将完整路径（如 E:oracleinstantclient_23_6）添加进系统 PATH，不要加尾部反斜杠，也不要加引号
6. 打开**全新 CMD 窗口**执行 sqlplus /nolog 验证

TNS_ADMIN 决定 tnsnames.ora 加载位置，ORACLE_HOME 对 Instant Client 无效

TNS_ADMIN 是唯一决定 Oracle 客户端去哪读 tnsnames.ora 的环境变量。设错路径、文件放错位置、甚至多一个不可见空格，都会导致连接失败。而 ORACLE_HOME 在 Instant Client 场景下基本没用，强行设置反而可能干扰其他 Oracle 工具。

1. 在 Instant Client 解压根目录下手动创建 networkadmin 子目录（路径必须是 networkadmin，大小写敏感）
2. 把正确格式的 tnsnames.ora 放进 admin 目录（内容不能含 BOM、多余空格或制表符）
3. 新建系统环境变量：TNS_ADMIN=E:oracleinstantclient_23_6networkadmin
4. CMD 中运行 set TNS_ADMIN，确认输出值与你设置的完全一致
5. 不要同时设 ORACLE_HOME，除非你明确需要兼容旧脚本或其它 Oracle 工具

位数和版本必须严格匹配 PL/SQL Developer

PL/SQL Developer 启动时报 “无法加载 oci.dll”，90% 是因为客户端位数（32/64）与工具本身不一致。版本倒退兼容性差，比如 PL/SQL Developer 14 调用 oraocci19.dll，但你装了 12c 的 Basic 包，就会找不到符号。

1. 右键 PL/SQL Developer 快捷方式 → 属性 → 详细信息 → 查看“体系结构”（x64 或 x86）
2. 下载对应位数的 Instant Client：instantclient-basic-windows.x64-*.zip（64 位）或 instantclient-basic-win32-*.zip（32 位）
3. 参考组合：PL/SQL Developer 12.x → Instant Client 12.2.0.1；14.x → 19.3.0.0 或 21.10；老版本 8.x 只能用 11.2.0.1
4. 如果 PL/SQL Developer 设置里手动填了 OCI 库路径，务必指向 oci.dll 所在目录（即解压根目录），且不能指向子目录

NLS_LANG 影响中文显示，但只在字符集不一致时才需显式设置

多数情况下，Windows 系统区域设置已足够，NLS_LANG 不是必设项。但它一旦设错（比如服务器用 ZHS16GBK，你设成 AL32UTF8），就会出现乱码或 ORA-12705 错误。

1. 先查服务器实际字符集：SELECT value FROM nls_database_parameters WHERE parameter = 'NLS_CHARACTERSET';
2. 常见值：SIMPLIFIED CHINESE_CHINA.ZHS16GBK（GBK）、AMERICAN_AMERICA.AL32UTF8（UTF-8）
3. 设为系统变量：NLS_LANG=SIMPLIFIED CHINESE_CHINA.ZHS16GBK（注意等号前后无空格）
4. 如果 PL/SQL Developer 连上后中文正常，就不用动这个变量

真正卡住人的，往往不是不会操作，而是解压路径里有空格、TNS_ADMIN 多了一层 network、或者 PL/SQL Developer 是 32 位却塞了 64 位的 oci.dll。这些细节不验证，光看教程步骤根本没法定位。