| 伺服器字元集 | 客戶端 NLS_LANG 範例 (語言_地域.字元集) |
| ZHS16GBK (簡體中文) | AMERICAN_AMERICA.ZHS16GBK、SIMPLIFIED CHINESE_CHINA.ZHS16GBK |
| ZHT16BIG5 (繁體中文) | TRADITIONAL CHINESE_TAIWAN.ZHT16BIG5 |
| AL32UTF8 (Unicode) | AMERICAN_AMERICA.AL32UTF8、ENGLISH_UNITED KINGDOM.AL32UTF8 |
| JA16SJIS (日文) | JAPANESE_JAPAN.JA16SJIS |
| KO16KSC5601 (韓文) | KOREAN_KOREA.KO16KSC5601 |
| WE8ISO8859P1 (西歐) | AMERICAN_AMERICA.WE8ISO8859P1 |
平台別設定方式
Linux/Unix Shell
# csh/tcsh
setenv NLS_LANG AMERICAN_AMERICA.ZHS16GBK
# bash/sh/ksh/zsh
export NLS_LANG=AMERICAN_AMERICA.ZHS16GBK
# 永久生效:寫入 ~/.bash_profile 或 /etc/profile
Windows
- 註冊表:
HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\KEY_{OracleHome}\NLS_LANG 修改字串值。
- CMD 臨時:
SET NLS_LANG=AMERICAN_AMERICA.ZHS16GBK。
- PowerShell 永久:
[Environment]::SetEnvironmentVariable('NLS_LANG','AMERICAN_AMERICA.ZHS16GBK','User')。
版本特定 NLS 資料目錄環境變數
| 版本 | 環境變數 | 預設路徑 |
| 10g / 11g / 12c / 18c / 19c | ORA_NLS10 | $ORACLE_HOME/nls/data |
| 9i / 9.2 | ORA_NLS33 | $ORACLE_HOME/ocommon/nls/data |
| 8i | ORA_NLS32 | $ORACLE_HOME/ocommon/nls/data |
# 10g+ 範例
export ORA_NLS10=$ORACLE_HOME/nls/data
# 9i 範例
export ORA_NLS33=$ORACLE_HOME/ocommon/nls/data
缺少此變數會導致 NLS_CHARACTERSET 查詢失敗、字元集轉換函數報錯 ORA-12705。
JDBC Thin 驅動特殊說明
- JDBC Thin 不讀取 NLS_LANG,字元轉換由 JVM
file.encoding 與驅動內部映射表決定。
- 確保啟動參數:
-Dfile.encoding=UTF-8 (或目標編碼)。
- 12.2+ 驅動支援
oracle.jdbc.defaultNCharset 覆蓋 NCHAR/NVARCHAR2 編碼。
驗證腳本
-- 伺服器端
SELECT userenv('language'), value FROM nls_database_parameters WHERE parameter='NLS_CHARACTERSET';
-- 客戶端 (SQL*Plus)
SELECT * FROM nls_session_parameters WHERE parameter IN ('NLS_LANGUAGE','NLS_TERRITORY','NLS_CHARACTERSET');
-- 測試中文顯示
SELECT '測試中文' FROM dual;
統一配置 NLS_LANG 與版本對應的 ORA_NLSxx,即可徹底解決 99% 的 Oracle 亂碼問題。
copyright ©
萬盛學電腦網 all rights reserved