新venv需先激活才能确保pip安装到目标环境，通过which python（linux/macos）或where python（windows）验证解释器路径，并检查终端提示符是否显示环境名前缀；导出依赖应优先使用requirements.txt，否则用pip freeze --local --exclude-editable，安装时对含c扩展的包优先用-binary版本，并验证真实调用链而非仅import。
确认新 venv 已创建且激活
迁移的前提是新环境干净、可控制。直接在旧环境中 pip install 到新路径会出错，必须先激活目标 venv。用 which python（macOS/Linux）或 where python（Windows）确认当前 python 指向是否为新 venv 的 bin/Scripts 目录下的解释器。没激活就执行后续操作，所有包仍会装进旧环境或系统 Python。
- Linux/macOS：
source /path/to/new_venv/bin/activate - Windows：
\path\to\new_venv\Scripts\activate.bat（cmd）或Activate.ps1（PowerShell，需先设置Set-ExecutionPolicy RemoteSigned -Scope CurrentUser） - 激活后提示符通常带括号前缀（如
(new_venv) $），这是最直观的验证方式
导出旧环境依赖（注意 --no-deps 和 --exclude-editable）
pip freeze 看似简单，但直接在旧 venv 中运行它会包含大量传递依赖和开发时临时安装的包，导致新环境臃肿甚至冲突。更稳妥的方式是只导出「你明确要求安装」的包：
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
- 如果旧项目有
requirements.txt，优先用它：pip install -r requirements.txt - 如果没有，且旧 venv 是你长期使用的，用
pip list --outdated --format=freeze不够准；改用pip freeze --local --exclude-editable，跳过系统包和-e .安装的本地包 - 避免用
pip freeze > requirements.txt后直接在新环境pip install -r——它会锁死版本号，可能因平台差异（如pywin32在 Linux 下报错）失败
安装时用 --no-deps 或分批处理可选依赖
有些包（如 scikit-learn、tensorflow）默认拉取特定版本的 numpy，而新 venv 的 Python 版本可能不兼容旧版 numpy。硬性按冻结文件安装容易卡在编译或 ImportError。
- 先装核心依赖：
pip install numpy pandas requests（手动列关键包） - 再装高层库，加
--no-deps跳过自动依赖：pip install --no-deps scikit-learn，之后单独检查并装缺失依赖 - 对含 C 扩展的包（如
psycopg2），优先试pip install psycopg2-binary，而非源码编译版，省去系统级依赖（libpq-dev等）配置
验证 import 和运行时行为差异
包名相同不代表行为一致。Python 3.9+ 对 ast.literal_eval 的安全限制更严，某些老库（如旧版 ruamel.yaml）在新 venv 中可能抛 RecursionError；pathlib.Path 在 3.12 中修改了 resolve() 的符号链接解析逻辑，影响依赖路径构造的代码。
- 别只测
import xxx成功，要跑真实调用链：python -c "import torch; print(torch.__version__); print(torch.cuda.is_available())" - 如果项目用
setuptools插件（如pytest的setup.py配置），确认新 venv 中pip install -e .能正确注册入口点，否则pytest命令可能找不到插件 - 虚拟环境间不共享
~/.cache/pip，首次安装会慢，但这是预期行为，不是错误
requirements.txt 却靠 sys.path.append() 或 PYTHONPATH 加载的私有模块——它们不会出现在 pip list 里，却在运行时报 ModuleNotFoundError。这种隐式依赖得靠 grep import 和 sys.path 手动补全。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
