必须同时满足Instant Client安装、匹配位数的ODBC管理器配置、TNS_ADMIN显式指向tnsnames.ora三条件，缺一不可；32位应用须用SysWOW64下odbcad32.exe配系统DSN，64位应用须用System32下odbcad32.exe；需手动运行odbc_install.exe注册驱动，TNS_ADMIN路径须无空格中文且重启进程生效。
必须用 Instant Client + 正确位数的 ODBC 管理器 + TNS_ADMIN 显式指向 tnsnames.ora，三者缺一不可。 光装驱动、光配 DSN、光写连接串，任一环节错配都会导致“驱动未找到”“ORA-12154”或“测试连接成功但应用连不上”。
确认应用位数并打开对应 odbcad32.exe
Excel、Power BI、Python（pyodbc）、旧版 VB6 等工具运行时有明确位数：32 位应用必须用 32 位 ODBC 数据源，64 位应用必须用 64 位。Windows 10/11 上两者完全隔离。
- 按
Win+R输入odbcad32.exe回车 —— 若标题栏含 “32-bit”，即为 32 位管理器；若无提示或显示 “64-bit”，即为 64 位 - 32 位应用（如默认安装的 Excel 2016/2019/365）必须在
C:\Windows\SysWOW64\odbcad32.exe中配置 - 64 位应用（如 64 位 Python 或 Power BI Desktop）必须在
C:\Windows\System32\odbcad32.exe中配置 - 错配后现象：DSN 测试能过，但应用调用
pyodbc.connect()或 Excel 导入时直接报“Data source name not found”或“Driver not found”
部署 Instant Client 并注册 ODBC 驱动
Oracle 不再随客户端自动注册 ODBC 驱动，必须手动运行 odbc_install.exe，且路径中不能含空格或中文。
- 下载匹配版本的两个 ZIP：
instantclient-basic-windows.x64-19.24.0.0.0dbru.zip和instantclient-odbc-windows.x64-19.24.0.0.0dbru.zip - 解压到同一目录，例如
D:\oracle\instantclient_19_24（确保路径无空格） - 以管理员身份运行 CMD，cd 进该目录，执行
odbc_install.exe—— 闪退即成功 - 验证注册：打开注册表编辑器，查看
HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBCINST.INI\ODBC Drivers下是否有Oracle in instantclient_19_24条目
配置 TNS_ADMIN 和 tnsnames.ora 路径
TNS_ADMIN 环境变量优先级高于 ORACLE_HOME，设错会导致 tnsping 可通、但 ODBC 连接失败 —— 因为 ODBC 驱动只认 TNS_ADMIN 指向的 tnsnames.ora。
- 创建目录：
D:\oracle\network\admin - 在该目录下新建
tnsnames.ora，内容示例：
ORCL19C =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.1.100)(PORT = 1521))
(CONNECT_DATA =
(SERVICE_NAME = ORCLPDB1)
)
)
- 设置系统环境变量：
TNS_ADMIN = D:\oracle\network\admin（使用setx TNS_ADMIN "D:\oracle\network\admin" /M） -
HOST必须填数据库服务器局域网 IP，不能写主机名（Windows 默认不查 DNS 做 Oracle 名称解析） -
SERVICE_NAME值需与数据库中SELECT value FROM v$parameter WHERE name = 'service_names';输出一致，大小写敏感
在 ODBC 管理器中创建系统 DSN
系统 DSN 对所有用户和应用可见，比用户 DSN 更可靠；名称里避免空格和特殊字符，否则某些工具（如 Excel 数据向导）会解析失败。
- 在已确认位数的
odbcad32.exe中，选“系统 DSN” → “添加” → 选择Oracle in instantclient_19_24 - 填写：
-
Data Source Name：纯英文，如ORCL19C_DSN -
TNS Service Name：填tnsnames.ora中定义的别名，如ORCL19C -
User ID：数据库用户名（如hr）
-
- 点击“Test Connection”，输入密码 —— 成功后才代表底层链路打通
- 若测试失败，先在 CMD 中运行
tnsping ORCL19C验证网络与解析是否正常；再检查sqlplus username/password@ORCL19C是否能登录
最容易被忽略的是：TNS_ADMIN 环境变量设完后，必须重启所有已打开的 CMD、IDE、Excel 等进程才能生效；而 ODBC 驱动注册后，部分老应用（如 VB6）还需重启整个操作系统才能识别新驱动。
