0

0

composer如何跳过git clone缓存_composer --no-cache参数详解【刷新】

尼克

尼克

发布时间:2026-02-26 14:11:09

|

159人浏览过

|

来源于php中文网

原创

composer install 仍走 git clone 缓存是因为它复用 vendor/ 和 ~/.composer/cache/vcs/ 中的 git 镜像,--no-cache 仅禁用元数据缓存而非源码副本;强制更新需清镜像、设 composer_cache_dir=/dev/null 或改用 dist 模式。

composer如何跳过git clone缓存_composer --no-cache参数详解【刷新】

composer install 为什么还是走 git clone 缓存

因为 composer install 默认不会跳过已有的 vendor 和 .git 目录缓存,哪怕加了 --no-cache,它只影响 Composer 的内部包元数据缓存(比如 packages.json),不清理 Git 克隆下来的源码副本。

常见错误现象:改了 repositories 指向私有 Git 分支,composer install --no-cache 后 vendor 里仍是旧 commit —— 实际上 Composer 复用了之前 git clone 出来的本地工作副本,根本没重新拉。

  • --no-cache 只禁用 HTTP 层和 packagist.org 元数据缓存,不影响 vendor/ 目录或 ~/.composer/cache/vcs/ 下的 Git 镜像
  • 真正触发重新 clone 的是「目标目录不存在」或「Git remote URL / reference 发生变化」
  • 如果只是想强制更新某一个包,composer update vendor/package --with-dependencies 更可靠,它会校验 lock 文件与远程 HEAD

如何真正绕过 git clone 缓存(VCS 镜像)

Composer 在 ~/.composer/cache/vcs/ 下维护 Git 仓库镜像(mirror),每次 install/update 都优先复用。要跳过它,得从源头切断镜像读取路径或清空对应缓存项。

厉害猫AI
厉害猫AI

遥遥领先的AI全职业办公写作平台

下载
  • 临时禁用 VCS 缓存:设置环境变量 COMPOSER_CACHE_DIR=/dev/null(Linux/macOS)或 set COMPOSER_CACHE_DIR=NUL(Windows),再运行 composer install
  • 手动清理特定包镜像:rm -rf ~/.composer/cache/vcs/https---github.com-vendor-package.git/(路径按实际 URL 转义)
  • composer clear-cache 清掉整个缓存,但注意这也会清掉下载的 zip 包,下次安装可能变慢
  • composer.json 中为包显式指定 "dist" 而非 "source",例如:
    {"type": "package","package": {"name": "vendor/pkg","version": "dev-main","dist": {"url": "https://example.com/pkg.zip","type": "zip"}}
    —— 这样就完全绕开 git clone

composer create-project --no-cache 不生效的真相

create-project--no-cache 同样只跳过元数据缓存,不阻止它从 ~/.composer/cache/vcs/ 拉镜像、解压、再 git checkout。尤其当你反复用相同包名创建项目时,几乎必然复用旧镜像。

  • 最稳妥做法:加 --remove-vcs(删掉 .git 目录),再配合 rm -rf ~/.composer/cache/vcs/* 彻底清镜像
  • 若用的是 GitHub/GitLab,可改用 dist 模式:在 composer.jsonrepositories 里把 "type": "vcs" 改成 "type": "package" 并提供 "dist" 字段
  • CI 场景下建议直接设 COMPOSER_CACHE_DIR=/tmp/composer-cache 并在 job 结尾 rm -rf /tmp/composer-cache,避免跨任务污染

为什么 vendor 下的包仍有 .git 目录

因为 Composer 默认以 source 方式安装开发版包(dev- 开头的版本),即执行 git clone 到 vendor 里。这不是 bug,是设计行为——方便你直接改代码、提交 PR。

  • 想彻底禁掉 .git:在 composer.json"prefer-dist": true,但前提是包本身提供了 dist 发布(GitHub Release / zip 包)
  • 某些私有包没配 dist,即使写了 "prefer-dist": true,Composer 仍 fallback 到 source,此时唯一办法是自己打包 zip 并在 repositories 里声明 "dist"
  • 检查是否真用了 source:看 vendor/vendor/package/.git/config 里的 url,和 composer show vendor/package 输出的 source 行一致

真正难处理的是混合场景:一部分包走 dist,一部分必须走 source,而你只想对其中某个包跳过 git clone —— 这时候就得单独拎出来用 package 类型定义,其他保持默认。细节容易漏,尤其是 URL 转义和 commit hash 校验。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
composer是什么插件
composer是什么插件

Composer是一个PHP的依赖管理工具,它可以帮助开发者在PHP项目中管理和安装依赖的库文件。Composer通过一个中央化的存储库来管理所有的依赖库文件,这个存储库包含了各种可用的依赖库的信息和版本信息。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

160

2023.12.25

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

448

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

544

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

324

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

81

2025.09.10

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

246

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

886

2024.03.01

github中文官网入口 github中文版官网网页进入
github中文官网入口 github中文版官网网页进入

github中文官网入口https://docs.github.com/zh/get-started,GitHub 是一种基于云的平台,可在其中存储、共享并与他人一起编写代码。 通过将代码存储在GitHub 上的“存储库”中,你可以: “展示或共享”你的工作。 持续“跟踪和管理”对代码的更改。

2859

2026.01.21

batoto漫画官网入口与网页版访问指南
batoto漫画官网入口与网页版访问指南

本专题系统整理batoto漫画官方网站最新可用入口,涵盖最新官网地址、网页版登录页面及防走失访问方式说明,帮助用户快速找到batoto漫画官方平台,稳定在线阅读各类漫画内容。

331

2026.02.25

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Git 教程
Git 教程

共21课时 | 3.9万人学习

Git版本控制工具
Git版本控制工具

共8课时 | 1.6万人学习

Git中文开发手册
Git中文开发手册

共0课时 | 94人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号