如何在Python Anaconda环境下安装cx_Oracle，解决无法定位Oracle软件报错？

Traceback (most recent call last): File "setup.py", line 132, in
raise DistutilsSetupError("cannot locate an Oracle software " \ distutils.errors.DistutilsSetupError: cannot locate an Oracle software
installation

优先适配Anaconda环境的方案（无额外依赖配置） #

不要使用pip安装，直接用Anaconda官方源的预编译包，自动处理所有依赖匹配：
conda install -c anaconda cx_oracle

手动pip安装的修复步骤 #

如果一定要用pip安装，按以下顺序排查：

• 确认架构完全匹配：Oracle Instant Client、Python解释器、操作系统的位数必须完全一致，三者都是32位或者都是64位，架构不匹配时环境变量配置无效
• 修正环境变量配置：
  1. 将Oracle Instant Client的根目录（包含oci.dll/oci.so/oci.dylib的文件夹）添加到系统PATH变量中，并且将该路径移动到PATH列表的最顶端，避免其他程序自带的Oracle客户端优先级更高
  2. 配置完成后必须重启Anaconda Prompt/终端，必要时重启操作系统，确保环境变量全局生效
• 安装前手动指定Oracle路径：
  Windows环境下执行：

  set ORACLE_HOME=C:\你的\instantclient\实际路径
  pip install cx_Oracle
  

  Linux/macOS环境下执行：

  export ORACLE_HOME=/你的/instantclient/实际路径
  pip install cx_Oracle
  

无Oracle客户端依赖的替代方案 #

Oracle官方已经将cx_Oracle升级重命名为python-oracledb，新版本默认不需要安装Oracle Instant Client就能使用，API完全兼容旧版cx_Oracle，直接安装即可：
pip install oracledb
使用时仅需将代码中import cx_Oracle修改为import oracledb，即可沿用所有原有逻辑，不需要额外调整。

内容的提问来源于stack exchange，提问作者Suneel Kumar