1. QuTiP 安装后导入失败的环境诊断

问题定位思路：先分清“装没装上”和“装对了没有”

import qutip 失败通常落在三类原因上：解释器选错（装到了另一个 Python 环境）、依赖版本不兼容（NumPy/SciPy/Cython 与 QuTiP 版本错配）、安装路径或二进制扩展损坏（wheel 与当前平台/Python ABI 不匹配）。排障顺序应从“确认当前解释器”开始，再逐层向内检查，而不是反复重装。

第一步：确认“当前解释器”就是“安装解释器”

最常见的假故障是：pip install qutip 装进了系统 Python，而 IDE 或终端实际运行的是虚拟环境里的另一个 Python。先打印解释器路径与版本，再确认包是否在该解释器下可见。

import sys, importlib.util

print("解释器:", sys.executable)
print("版本:", sys.version.split()[0])

spec = importlib.util.find_spec("qutip")
print("qutip 可见:", spec is not None)
if spec is not None:
    print("包位置:", spec.origin)

若 find_spec 返回 None，说明当前解释器根本看不到 qutip，此时任何“版本不匹配”的猜测都无意义，应先用 python -m pip install qutip 在同一解释器下安装（python -m pip 能保证 pip 与解释器绑定）。

第二步：包可见但导入失败，检查依赖版本

若 find_spec 有结果而 import qutip 仍报错，问题多半在依赖。QuTiP 对 NumPy、SciPy、Cython 有明确版本区间，NumPy 2.x 与旧版 QuTiP 组合是高频冲突点。用 pip check 一次性列出所有不满足的依赖声明：

python -m pip check
python -m pip show qutip numpy scipy cython

输出中若出现 qutip x.y.z requires numpy<2, but you have numpy 2.1.0 之类的行，即为版本错配。修复时按 QuTiP 声明的区间锁定依赖，而不是盲目升级全部包：

python -m pip install "numpy<2" "scipy>=1.9" --upgrade
python -m pip install --force-reinstall --no-deps qutip

第三步：区分“版本错配”与“二进制损坏”

两类报错信息形态不同，判读方式也不同：

对二进制类问题，优先使用预编译 wheel 而非源码编译，可显著降低 ABI 不匹配概率：

python -m pip install --only-binary :all: --force-reinstall qutip

第四步：修复后的验证闭环

修复不能以“没报错”为终点，应验证版本、路径与最小功能三者一致：

import qutip, numpy, scipy, sys

print("python:", sys.version.split()[0])
print("qutip :", qutip.__version__, "->", qutip.__file__)
print("numpy :", numpy.__version__)
print("scipy :", scipy.__version__)

# 最小功能验证：构造并演化一个两能级系统
H = 0.5 * qutip.sigmaz()
psi0 = qutip.basis(2, 0)
result = qutip.mesolve(H, psi0, [0, 1], [], [qutip.sigmax()])
print("期望值序列:", [round(float(x), 4) for x in result.expect[0]])