sqlplus /nolog报“不是内部或外部命令”是因为PATH未正确指向Instant Client解压根目录，需将instantclient-basic与sqlplus两个ZIP包直接解压到同一纯英文无空格路径（如E:\oracle\instantclient_23_6），确保sqlplus.exe与oci.dll等文件平级存在，并将该路径完整添加至系统PATH，然后新开CMD验证。
sqlplus /nolog 报“不是内部或外部命令”？先检查 PATH 是否指向解压目录
这几乎是 windows 上最常遇到的问题，根本原因不是没装对，而是 path 没生效或指向错误位置。
关键点：Instant Client 是免安装的 ZIP 包，sqlplus.exe 必须和 oci.dll、oraocci19.dll 等文件在同一级目录下——不能有嵌套子文件夹。
- 下载
instantclient-basic-windows.x64-*.zip和instantclient-sqlplus-windows.x64-*.zip两个包 - 新建一个纯英文、无空格、无括号的路径（如
E:\oracle\instantclient_23_6） - 把两个 ZIP 全部**直接解压到该目录**（不是各自解压出子文件夹）
- 确认目录下能看到
sqlplus.exe、oci.dll、oraocci23.dll等文件平级存在 - 在系统环境变量
PATH中新增这一整条路径（不要加尾部\，也不要加引号） - 打开**全新的 CMD 窗口**再试
sqlplus /nolog
tnsnames.ora 找不到或连接失败？TNS_ADMIN 环境变量比 ORACLE_HOME 更关键
ORACLE_HOME 对 Instant Client 实际无效，强行设置反而可能干扰其他 Oracle 工具；真正决定 tnsnames.ora 加载位置的是 TNS_ADMIN。
它必须精确指向 network\admin 这个完整路径，且该目录下要有 tnsnames.ora 文件。
- 在 Instant Client 解压根目录下手动创建
network\admin子目录 - 把
tnsnames.ora放进admin目录（内容格式必须正确，不能有多余空格或不可见字符） - 新建系统环境变量：
TNS_ADMIN=E:\oracle\instantclient_23_6\network\admin - 别用
ORACLE_HOME替代它——哪怕你设了，Oracle 也不会读%ORACLE_HOME%\network\admin - 验证方式：CMD 中执行
set TNS_ADMIN，确认输出值与你设置的一致
OCI 库加载失败（如 PL/SQL Developer 找不到 oci.dll）？路径和位数必须严格匹配
PL/SQL Developer 或其他依赖 OCI 的工具启动时报 “无法加载 oci.dll”，通常不是 DLL 缺失，而是调用方与 DLL 的位数不一致，或路径未被识别。
- 确认 PL/SQL Developer 是 64 位还是 32 位（查看其属性 → 详细信息 → 体系结构）
- 下载对应位数的 Instant Client（
instantclient-basic-windows.x64-*.zip对应 64 位，instantclient-basic-win32-*.zip对应 32 位） - 在 PL/SQL Developer 的「首选项 → 连接」中，
Oracle 主目录名填 Instant Client 根目录（如E:\oracle\instantclient_23_6），OCI 库填完整路径（如E:\oracle\instantclient_23_6\oci.dll） - 不要只填
oci.dll或相对路径——必须是绝对路径 - 如果仍失败，用
depends.exe或dumpbin /dependents oci.dll查看是否缺vcruntime140.dll等 VC++ 运行库（需安装 Visual C++ 2015–2022 Redistributable）
Linux 下 oci.so 找不到共享库？LD_LIBRARY_PATH 不是唯一解法
在 Linux 上，仅靠 LD_LIBRARY_PATH 容易被 shell 配置覆盖或权限限制，更稳定的做法是让系统级动态链接器直接识别。
- 解压后确认
libclntsh.so、libnnz23.so等文件在 Instant Client 目录下 - 不要只靠用户级
export LD_LIBRARY_PATH=...，优先执行：sudo sh -c "echo /u01/instantclient_23_6 > /etc/ld.so.conf.d/oracle.conf"sudo ldconfig - 验证：运行
ldd sqlplus | grep "not found"，若无输出说明依赖已就绪 - 如果用 Python cx_Oracle 或 node-oracledb，它们会绕过
LD_LIBRARY_PATH直接查系统缓存，所以ldconfig这步不能跳 - 注意：某些容器或最小化系统缺
libaio，需额外yum install libaio或apt install libaio1
oci.dll 静默失效，Linux 下忘记 ldconfig 则所有应用都找不到库。这些不是配置错误，而是运行时机制本身的硬性要求。
