离线迁移conda环境后Jupyter Notebook启动失败问题排查

报错核心是Jupyter尝试启动的Python路径为D:\bld\ipykernel_1719845595208\_h_env\python.exe，这个路径是线上设备打包ipykernel时的临时编译路径，离线机器不存在该路径，因此触发「找不到文件」错误。

conda环境手动tar打包迁移时，部分依赖包（如ipykernel）会将安装时的绝对路径硬编码到配置文件中，直接迁移后这些路径不会自动适配离线机器的环境路径。

• 激活迁移后的环境：

  conda activate transfer_env
  

• 强制重装ipykernel以覆盖硬编码路径：
  用pip重装：

  pip install --force-reinstall ipykernel
  

  或用conda重装：

  conda install --force-reinstall ipykernel
  

• 重新注册内核到Jupyter：

  python -m ipykernel install --user --name transfer_env --display-name "Python (transfer_env)"
  

• 关闭现有Jupyter进程，重新启动：

  jupyter notebook
  

手动tar打包容易出现路径问题，建议使用conda官方工具conda pack，它会自动处理路径替换：

• 线上设备安装conda-pack：

  conda install conda-pack
  

• 打包目标环境：

  conda pack -n your_env_name -o transfer_env.tar.gz
  

• 离线机器解压到conda环境目录：

  mkdir -p C:\Users\my_user\.conda\envs\transfer_env
  tar -xzf transfer_env.tar.gz -C C:\Users\my_user\.conda\envs\transfer_env
  

• 激活环境即可正常使用：

  conda activate transfer_env
  

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