langchain 1.5.0要求python 3.11或更高及langchain-core 1.8.0或更高。旧项目应新建受支持解释器的虚拟环境，在保留原环境的前提下重新安装并检查依赖；不要通过更改现有虚拟环境目录中的解释器文件来原地迁移。
Python官方独立虚拟环境说明
记录现有依赖并建立新环境
python -m pip freeze > requirements-before-lc15.txt python3.11 -m venv .venv-lc15 .venv-lc15/bin/python -m pip install --upgrade pip
以上创建命令示例面向已安装Python 3.11的macOS或Linux。Windows可用py -3.11 -m venv .venv-lc15，后续解释器路径改为.venv-lc15\Scripts\python.exe。确认实际解释器版本后再继续，旧环境和依赖清单保留用于回退。
Python官方venv创建命令
安装LangChain及应用依赖
.venv-lc15/bin/python -m pip install "langchain==1.5.0"
.venv-lc15/bin/python -m pip check
.venv-lc15/bin/python -c "import sys; from importlib.metadata import version; print(sys.version); print(version('langchain'), version('langchain-core'))"
再安装项目需要的供应商集成包和其他依赖。如果项目已有requirements或锁文件，先调整其LangChain和Python约束，再用项目原有工具重新解析；旧清单中的1.4.x固定版本不能未经处理直接覆盖新环境。解析冲突时检查冲突包的支持范围，不使用忽略依赖来强装。
验证工作流后切换服务
用新环境运行项目已有测试及关键Agent调用，核对工具调用、输出结构和所用模型集成。通过后让服务管理器、容器或IDE明确使用新解释器。ModelRouterMiddleware在1.5.0仍标为Beta，升级基础包不要求同时引入它；旧项目可先完成运行环境迁移。
