換鏡像源可解決Composer創(chuàng)建項(xiàng)目卡住問(wèn)題。首先設(shè)置國(guó)內(nèi)鏡像如阿里云，執(zhí)行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/；若仍卡頓，使用-vvv參數(shù)查看詳細(xì)日志，確認(rèn)是否在解析依賴(lài)；同時(shí)檢查PHP版本是否符合項(xiàng)目要求，更新Composer至最新版；確保目標(biāo)目錄有讀寫(xiě)權(quán)限且磁盤(pán)空間充足；對(duì)于含Git子模塊的項(xiàng)目，可嘗試加--no-install參數(shù)跳過(guò)安裝階段。多數(shù)情況通過(guò)切換鏡像和排查環(huán)境問(wèn)題即可解決。

使用 composer create-project 命令時(shí)卡住不動(dòng)，通常不是單一原因?qū)е碌?，而是與網(wǎng)絡(luò)、配置、資源或依賴(lài)解析有關(guān)。以下是常見(jiàn)原因及對(duì)應(yīng)的解決方法。

1. 網(wǎng)絡(luò)連接問(wèn)題（最常見(jiàn)）

Composer 需要從遠(yuǎn)程倉(cāng)庫(kù)（如 packagist.org）下載項(xiàng)目和依賴(lài)包，如果網(wǎng)絡(luò)不穩(wěn)定或被墻，容易卡在某個(gè)步驟。

• 嘗試切換 Composer 鏡像源為國(guó)內(nèi)鏡像（如阿里云、Laravel China）
• 執(zhí)行以下命令設(shè)置鏡像：

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

2. 依賴(lài)解析耗時(shí)過(guò)長(zhǎng)

某些項(xiàng)目依賴(lài)復(fù)雜，Composer 需要花時(shí)間分析版本兼容性，看起來(lái)像是“卡住”。

• 耐心等待幾分鐘，Composer 可能在后臺(tái)計(jì)算依賴(lài)
• 加上 -vvv 參數(shù)查看詳細(xì)輸出，確認(rèn)是否在工作：

composer create-project xxx -vvv

3. PHP 或 Composer 版本不兼容

目標(biāo)項(xiàng)目可能要求較新或特定版本的 PHP，當(dāng)前環(huán)境不滿(mǎn)足會(huì)導(dǎo)致卡頓或失敗。

因賽AIGC

因賽AIGC解決營(yíng)銷(xiāo)全鏈路應(yīng)用場(chǎng)景

73

查看詳情

• 運(yùn)行 php -v 確認(rèn) PHP 版本符合項(xiàng)目要求
• 更新 Composer 到最新版：

composer self-update

4. 權(quán)限或磁盤(pán)問(wèn)題

目標(biāo)目錄無(wú)寫(xiě)權(quán)限，或磁盤(pán)空間不足，也可能導(dǎo)致進(jìn)程停滯。

• 檢查目標(biāo)文件夾是否有讀寫(xiě)權(quán)限
• 確認(rèn)磁盤(pán)剩余空間足夠（尤其是大型項(xiàng)目）
• 避免在系統(tǒng)保護(hù)目錄（如 /usr、C:\Program Files）下創(chuàng)建項(xiàng)目

5. Git 或其他 VCS 干擾

如果項(xiàng)目包含大量 Git 子模塊或私有包，Composer 可能卡在克隆代碼階段。

• 嘗試加 --no-install 先跳過(guò)依賴(lài)安裝：

composer create-project vendor/name --no-install

基本上就這些。先換鏡像、加 -vvv 查日志，再檢查環(huán)境和權(quán)限，多數(shù)情況都能解決?？ㄗ〔灰欢ㄕ妗八馈?，可能是慢或等待響應(yīng)。保持 Composer 和 PHP 更新，能減少很多問(wèn)題。

以上就是composer create-project卡住不動(dòng)是什么原因的詳細(xì)內(nèi)容，更多請(qǐng)關(guān)注php中文網(wǎng)其它相關(guān)文章！