lip 的報錯
lip 安裝包時反覆失敗(下載中斷、緩存損壞等),如何清理 lip 緩存?緩存在哪裡?
執行 lip cache clean 刪除 lip 的緩存後重新安裝(舊命令 lip cache purge 已不存在)。緩存目錄在 Windows 上是 %LOCALAPPDATA%\lip\Cache,其他系統為 $XDG_CACHE_HOME/lip(默認 ~/.cache/lip),與服務端/lip 安裝在哪個盤無關;在 lip 自帶的界面中也可在設置頁點 "Clear cache"。緩存只保存可重新下載的內容,清理不影響服務端、已裝包和配置;不要在其他 lip 命令下載時清理。新版 lip 會自動替換不是有效 ZIP 的緩存文件,所以通常已很少需要手動清理。
排查失敗原因請看命令輸出的 error/hint,以及服務端目錄 .lip/logs/ 下的完整報告。配置項用 lip config set <键> <值> 設置、lip config list 查看(如 GitHub 代理 github_proxy)。
適用版本:lip 0.41.x
用 lip(或 LeviLauncher 內置的 lip)安裝/更新 LeviLamina 或模組時報依賴解析失敗(舊版提示 Cannot find a valid state to satisfy all dependencies.,啟動器裡顯示 ERR_LIP_INSTALL_FAILED),是什麼原因?
這是依賴解析失敗:找不到一組能同時滿足所有已安裝/要安裝的包依賴範圍的版本。最常見的原因是已安裝的某些模組只聲明支持舊版 LeviLamina/遊戲版本(例如某 mod 只匹配 LeviLamina 26.51.x),還沒適配新版本。新版 lip 的報錯為 Cannot find versions of the packages that work together:,並逐條列出衝突原因和 hint,詳細信息見工作區 .lip/logs/ 下的失敗報告。
解決辦法:等相關模組發佈適配新版本的版本,或先卸載這些模組(lip uninstall <包>)再升級。命令行下更換遊戲/LeviLamina 版本應使用 lip setup --game <版本>,它會列出無法配合新版本的模組並詢問是否卸載它們;lip install/lip update 不會改動遊戲和加載器,無法滿足時會提示改用 lip setup。
適用版本:lip 0.40 及以上(含 0.41.1);LeviLauncher 1.1.x 內置 lip
用 lip 安裝/更新 LeviLamina 或插件時失敗(下載/解壓報錯、進度卡住、緩存讀取出錯、依賴不滿足等),怎麼辦?
多數是 lip 緩存損壞、lip 版本過舊或訪問 GitHub 的網絡問題:
- 執行
lip cache clean清空緩存後重試(執行時不要有其他 lip 命令在運行)。緩存目錄:Windows 為%LOCALAPPDATA%\lip\Cache,Linux/macOS 為~/.cache/lip;清緩存不影響工作區、已裝的包和配置。 - 執行
lip self-update把 lip 更新到最新版,舊版 lip 無法安裝新格式的包。 - 訪問 GitHub 困難時配置 GitHub 代理:
lip config set github_proxy <代理地址>;配置有問題時用lip config delete github_proxy重置。普通 HTTP 代理無需專門配置,lip 會使用終端裡的HTTPS_PROXY/HTTP_PROXY/ALL_PROXY環境變量或系統代理。 - 安裝 LeviLamina 請用
lip install LeviLamina(或lip setup),讓 lip 自動選擇 LeviLamina 支持的遊戲版本,不要指定 LeviLamina 尚未適配的 BDS 版本;新建服務器建議在空文件夾中進行。 - 失敗時 lip 會在工作區
.lip/logs/下寫失敗報告,可據此排查或反饋。
lipui 早已不再維護,直接在終端輸入 lip(不帶參數)即可打開 lip 自帶的界面。
適用版本:lip 0.41.x(當前版本)
lip install 時包名帶 https:// 前綴(如 https://github.com/...)安裝失敗,怎麼辦?
Git 倉庫形式的包標識不要寫協議前綴,把 https:// 去掉,並檢查路徑大小寫/拼寫,例如 lip install github.com/LiteLDev/LegacyScriptEngine。在 lip 中以 https:// 開頭的參數會被當作“ZIP 壓縮包的下載地址”,倉庫網頁地址不是 ZIP,因此會失敗。
lip 執行報錯,但環境變量正常,服務器目錄路徑中含有“×”之類的特殊符號,是什麼原因?
路徑中的特殊符號可能導致 lip(或其調用的程序)出錯。把服務器所在目錄改成不含特殊符號(最好也不含中文、空格)的路徑後再運行。
適用版本:舊版 lip 報告;新版未確認。未能從源碼或文檔中直接證實,僅供參考。
在 LeviLauncher 中右鍵更新已安裝的 mod(顯示有新版本)時報 ERR_NO_UPDATE_SOURCE(沒有可用的更新源),怎麼辦?
ERR_NO_UPDATE_SOURCE 是 LeviLauncher 自己給出的錯誤:啟動器無法把該已安裝 mod 唯一地對應到模組目錄中的某個 lip 包(沒有匹配到,或按名稱匹配到多個包),或者沒有可用的目標版本,因此不知道從哪裡更新。可先把 LeviLauncher 更新到最新版本;臨時辦法是到啟動器的 LeviMC 模組(模組目錄)頁面裡找到該 mod,直接重新安裝新版本。
適用版本:LeviLauncher(含 1.1.0 內置 lip 兼容包管理器)
在 LeviLauncher 裡更新 mod(如 Lamium)時報錯,大意是 lip 連不上 GitHub,怎麼辦?
mod 的包和文件託管在 GitHub 上,需要能訪問 GitHub。可以:
- 開啟系統代理後重試(LeviLauncher 在 Windows 上會讀取系統/WinHTTP 代理設置)。
- 在啟動器「設置」的 lip 部分配置「GitHub 代理」(可選預設如 https://gh-proxy.org/https://github.com,也可手填,留空恢復默認),或用
lip config set github_proxy <URL>設置 lip 的 GitHub 代理,啟動器在未單獨設置時會讀取 lip 的config.toml中的github_proxy。
適用版本:LeviLauncher 1.1.0;lip 0.40 及以上
用 lip 安裝 LeviLamina 時報錯無法獲取依賴(如獲取不到 PreLoader 等依賴包)怎麼辦?
多半是訪問 GitHub 失敗。先看 lip 輸出的 error:/hint: 行和 .lip/logs/ 下的失敗報告判斷原因。GitHub 慢或被牆時:設置 GitHub 代理 lip config set github_proxy <代理地址>(該代理必須支持 git 倉庫),或使用網絡代理——lip 會讀取終端的 HTTPS_PROXY/HTTP_PROXY/ALL_PROXY 環境變量,未設置時使用系統代理(例如 PowerShell 中 $env:HTTPS_PROXY = "http://127.0.0.1:7890" 後再執行 lip install)。若懷疑下載緩存損壞,可執行 lip cache clean 清理緩存後重試(不要在其他 lip 命令下載時清理)。
適用版本:lip 0.40 及以上(新版 C# lip)
用 lip 安裝 LeviLamina 時執行 .\PeEditor.exe -mb 失敗,返回退出碼 -1073741515(例如舊版報 CliWrap.Exceptions.CommandExecutionException ... Command: cmd.exe /c ".\PeEditor.exe -mb"),怎麼解決?
退出碼 -1073741515(0xC0000135)表示缺少依賴 DLL,通常是沒有安裝 Microsoft Visual C++ 運行庫(x64)。新版 lip 在 lip setup/安裝 Windows 服務端時會檢測並自動安裝 VC++ 運行庫(需要在 UAC 彈窗中允許以管理員身份運行);如果拒絕了 UAC 或自動安裝失敗,請手動從 https://aka.ms/vc14/vc_redist.x64.exe 下載安裝,然後重新執行 lip install。
PeEditor 是 LeviLamina 包的 post_install hook,失敗時新版 lip 會提示「A hook command of a package failed」,詳細輸出見 .lip/logs/ 下的失敗報告。
適用版本:當前版本(Windows 服務端)