NLS_LANG必须严格匹配数据库NLS_CHARACTERSET且为三段式LANGUAGE_TERRITORY.CHARACTERSET,否则Oracle直接忽略;需先执行SELECT VALUE FROM NLS_DATABASE_PARAMETERS WHERE PARAMETER='NLS_CHARACTERSET'查清真实字符集,再按客户端类型(CMD、PL/SQL Developer、Java/Python)分别配置并验证NLS_SESSION_PARAMETERS。

NLS_LANG 必须匹配数据库字符集,且三段式格式缺一不可,否则 Oracle 直接忽略该变量
查清数据库实际字符集再动手
不查 NLS_CHARACTERSET 就设 NLS_LANG,等于凭感觉配编码。执行这条 SQL 获取真实值:
SELECT VALUE FROM NLS_DATABASE_PARAMETERS WHERE PARAMETER = 'NLS_CHARACTERSET';
常见返回值:
-
ZHS16GBK:Windows 中文系统本地库常见 -
AL32UTF8:Linux/云环境主流,也见于新装 Oracle -
UTF8:旧版 Oracle 使用,已不推荐
注意:NLS_NCHAR_CHARACTERSET 是给 NVARCHAR2 用的,和普通字段无关,别查错。
Windows 命令行(SQL*Plus)下必须三段齐全
CMD 默认代码页是 936(即 GBK),但很多人设成 AL32UTF8,结果字节流被错误解码,中文变问号或方块。
NLS_LANG 格式严格为 LANGUAGE_TERRITORY.CHARACTERSET,顺序不能乱、不能缺段:
- ✅ 正确示例:
AMERICAN_AMERICA.ZHS16GBK、SIMPLIFIED CHINESE_CHINA.AL32UTF8(空格允许,但别加引号) - ❌ 错误写法:
ZHS16GBK(缺 LANGUAGE_TERRITORY)、AMERICAN.ZHS16GBK(缺 TERRITORY)、AMERICAN_AMERICA.AL32UTF8(CMD 终端是 GBK 却配 UTF-8)——Oracle 会直接忽略该变量
临时生效:在启动 sqlplus 前执行 set NLS_LANG=AMERICAN_AMERICA.ZHS16GBK;永久设置要改系统环境变量,且必须重启 CMD 才加载。
PL/SQL Developer 等 GUI 工具会覆盖系统级 NLS_LANG
很多用户设了系统环境变量,但 PL/SQL Developer 启动后中文仍乱码,是因为它有自己的配置入口,优先级更高:
- 菜单栏 → 工具 → 首选项 → Oracle → 连接 → 语言,填入完整三段式值,如
AMERICAN_AMERICA.ZHS16GBK - 如果用了 Instant Client 启动(比如
plsqldev.bat),还要检查脚本里是否硬编码了set NLS_LANG=—— 这个值会覆盖注册表和系统变量 - 注册表路径
HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\KEY_OraDb11g_home1\NLS_LANG只对 GUI 工具生效,命令行不读这里
Java/Python 应用根本不用 NLS_LANG
NLS_LANG 对 JDBC 和 cx_Oracle/oracledb 完全无效,它们不读这个环境变量:
- Java:必须在 JDBC URL 显式指定字符集,例如:
jdbc:oracle:thin:@host:1521:orcl?useUnicode=true&characterEncoding=UTF-8(对应AL32UTF8数据库) - Python:需在连接参数中指定
encoding='UTF-8'、nencoding='UTF-8'
验证是否真生效,不能只看环境变量是否设置了,连上后必须查:
SELECT * FROM NLS_SESSION_PARAMETERS WHERE PARAMETER IN ('NLS_LANGUAGE', 'NLS_TERRITORY', 'NLS_CHARACTERSET');
重点看返回的 NLS_CHARACTERSET 是否与数据库一致。最容易被忽略的是:客户端操作系统代码页(chcp 查出的值)和 NLS_LANG 的 CHARACTERSET 段没有强绑定关系——它只告诉 Oracle “我期望你发什么编码”,真正决定能否显示正确的是这个值是否与数据库存储编码一致。











