必须手动设置ORACLE_HOME和PATH；ORACLE_HOME须为Instant Client解压根目录（如C:\oracle\instantclient_19_26，末尾无反斜杠），PATH中需添加该绝对路径（非\bin子目录）并置顶，同时设NLS_LANG=AMERICAN_AMERICA.AL32UTF8等完整格式及TNS_ADMIN指向含tnsnames.ora的目录。
必须手动设置 oracle_home 和 path，仅靠安装程序不会自动配置；nls_lang 不设会导致中文乱码或连接失败，不是可选项。
怎么设置 ORACLE_HOME 和 PATH 才生效
Windows 不识别 %ORACLE_HOME%\bin 这类嵌套变量引用，所以不能只写 PATH 里加 %ORACLE_HOME%\bin —— 必须展开为绝对路径。
-
ORACLE_HOME值必须是 Instant Client 解压后的根目录，例如：C:\oracle\instantclient_19_26，末尾不加反斜杠 -
PATH中要新增一项：C:\oracle\instantclient_19_26（不是...\bin，Instant Client 没有单独的bin子目录） - 这一项必须放在
PATH列表最顶部，否则可能被旧 Oracle 客户端路径覆盖，导致oci.dll加载失败 - 改完后必须重启所有已打开的 CMD/PowerShell/IDE，环境变量不会热更新
NLS_LANG 字符集必须匹配数据库端
设错 NLS_LANG 的典型表现是：SQL*Plus 能连上但中文显示为问号、cx_Oracle 报 ORA-12705、PL/SQL Developer 启动时弹窗报“oraclehomekey not found”。
- 推荐值：
AMERICAN_AMERICA.AL32UTF8（对应数据库用 UTF8 字符集）或SIMPLIFIED CHINESE_CHINA.ZHS16GBK（对应 GBK 数据库） - 不要写成
ZHS16GBK单独一个值 —— 格式必须是LANGUAGE_TERRITORY.CHARSET - 如果数据库字符集是
AL32UTF8，但客户端设成ZHS16GBK，插入中文会变成乱码，且不可逆 - 该变量设在“系统变量”里，不是用户变量；PL/SQL Developer 等工具只读系统级环境变量
为什么 TNS_ADMIN 经常被忽略却很关键
没有 TNS_ADMIN，sqlplus user/pass@ORCL 这种 TNS 别名写法会直接报 ORA-12154: TNS:could not resolve the connect identifier，哪怕 tnsnames.ora 文件真实存在。
-
TNS_ADMIN值必须指向含tnsnames.ora的文件夹，例如：C:\oracle\instantclient_19_26\network\admin - 这个目录下至少要有
tnsnames.ora，内容格式不能有 BOM、不能用 Unix 换行（CR+LF 是必须的） - 如果只是用 Easy Connect 语法（如
sqlplus user/pass@//host:1521/orcl），可暂时不设TNS_ADMIN，但生产环境几乎必用别名 - 注意大小写：Windows 下变量名不敏感，但某些 OCI 库（如较老版本
cx_Oracle）会严格检查TNS_ADMIN是否全大写
真正容易卡住的地方不是路径写错，而是 PATH 顺序、NLS_LANG 格式、tnsnames.ora 文件编码这三项叠加出问题 —— 任意一个不对，错误现象都类似，但根源完全不同。
