離線電腦搬移 Conda 環境:工具無法執行的原因與修復方法(以 uvicorn 示範)

💡 原文中文,约1800字,阅读约需5分钟。
📝

内容提要

在无网络的 Windows 环境中迁移 Conda 虚拟环境时,启动器 .exe 中的 Python 路径不一致可能导致工具无法启动。解决方法是确保新旧电脑的 Conda 安装路径相同;如果无法实现,可以使用 python -m 直接执行或创建 .cmd 启动器进行修复。

🎯

关键要点

  • 在無網絡的 Windows 環境中,遷移 Conda 虛擬環境可能導致工具無法啟動。
  • 確保新舊電腦的 Conda 安裝路徑一致是解決問題的最簡單方法。
  • 如果無法保持相同路徑,可以使用 python -m 直接執行工具或建立 .cmd 啟動器進行修復。
  • Windows 版本的 pip/conda 在安裝工具時會生成 .exe 啟動器,這些啟動器中寫死了 Python 的絕對路徑。
  • 當環境被搬到新位置時,舊的 Python 路徑會導致工具無法啟動。
  • 第一種修復方法是使用 python -m 直接執行模組,這是最快速、最簡單的方式。
  • 第二種修復方法是建立 .cmd 檔案來覆蓋舊的啟動器,這樣可以繼續使用短指令啟動工具。
  • 建立的 .cmd 檔案應放在環境主資料夾中,以確保其優先於壞掉的 .exe 被找到。
  • 在完全離線的狀況下,這兩種修復方法都能有效恢復工具的正常運作。
➡️

继续阅读