Composer怎么用preferred-install_Composer安装方式配置教程【核心】
Composer怎么用preferred-install：安装方式配置教程【核心】 preferred-install 是什么，为什么会影响你的 vendor 目录 简单来说，preferred-install 是 Composer 的一个配置项，可以在全局或项目级别设置。它不负责决定“包要不要安装
Composer怎么用preferred-install：安装方式配置教程【核心】
preferred-install 是什么，为什么会影响你的 vendor 目录
简单来说，preferred-install 是 Composer 的一个配置项，可以在全局或项目级别设置。它不负责决定“包要不要安装”，而是控制一个更底层的细节：包到底以哪种形式被拉取到本地。选项有两个：dist（下载压缩包）和 vcs（克隆 Git 仓库）。
默认值是 auto，意思是交给 Composer 自动判断。听起来很省心，对吧？但问题恰恰出在这里。这个“自动”逻辑，常常导致你的 vendor 目录变成一个混合体：一部分包是压缩包，另一部分却是完整的 Git 仓库。这种不一致性，会在调试、项目打包或者 CI/CD 构建流程中，埋下意想不到的麻烦。
怎么设置 preferred-install：全局 vs 项目级
设置的位置决定了影响的广度，千万别只改了一处，然后疑惑为什么没效果。
- 全局配置（影响你机器上的所有项目）：
composer config -g preferred-install dist
- 当前项目配置（仅影响当前目录下的项目）：
composer config preferred-install vcs
- 显式写入 composer.json（推荐用于团队协作，确保一致性）：
"config": { "preferred-install": "dist" }
这里有个关键点需要注意：composer config 命令修改的是 composer.json 或全局的 config.json 文件，而不是 composer.lock。所以，修改配置后，必须等到下一次执行 composer install 或 composer update 时，新规则才会被应用。如果想让已安装的包也遵循新规则，通常需要先删除 vendor 目录，再重新安装。
dist 和 vcs 的实际差异，不只是“快慢”那么简单
选择 dist 还是 vcs，不能只看下载速度，得根据你的实际场景来定：
dist模式：直接下载 ZIP 或 TAR 压缩包，解压即可。这种方式没有.git目录，你无法执行git status或git checkout等操作。它的优势是速度快、体积相对小，非常适合生产环境部署、CI/CD 流水线以及 Docker 镜像构建。vcs模式：通过git clone获取完整的代码仓库，包含所有提交历史。这意味着你可以自由切换分支、查看提交记录、甚至临时打补丁。但代价是首次安装慢、占用磁盘空间多，并且可能因为网络问题或仓库权限导致失败。- 当设置为
auto时，Composer 的倾向是：对于 Packagist 上的稳定版本，优先使用dist；而对于dev-开头的分支，或者当项目minimum-stability设置为dev时，则倾向于使用vcs。
常见的操作误区包括：在 CI 脚本中配置了 vcs，却因为无法访问私有 Git 服务器而导致构建卡住；或者在本地开发时用了 dist，等到需要临时修改某个依赖包的源码时，才发现找不到 .git 文件夹。
如何验证 preferred-install 是否生效
配置完了，怎么确认真的起作用了呢？别只看命令行的成功提示，得检查实际生成的文件结构。
- 运行
composer show -s vendor/package-name，查看输出中的 “Source” 一行，它会明确显示是git还是dist。 - 直接进入
vendor/vendor-name/package-name目录，执行ls -A | grep git命令。如果存在.git文件夹，说明该包是以vcs方式安装的；反之，则是dist。 - 如果你发现同一个项目里，有些包是
vcs，有些是dist，这很正常。这说明preferred-install只是一个“偏好”设置，并非强制。某些包会因为其composer.json中定义的type，或者版本约束（例如dev-main）而绕过你的偏好设置。
还有一个容易忽略的细节：有些包根本不走 preferred-install 的逻辑。比如，通过 path 类型的 repository 定义的本地包，其安装方式由 repository 类型直接决定，完全不受此配置影响。
AirBuddy 3 是面向 macOS 的蓝牙外设增强工具，可集中查看 AirPods、Beats 与苹果设备电量，提供快速连接、播放控制、电量提醒、桌面小组件和多台 Mac 外设接力等功能。
AirServer macOS版可把 Mac 转换为无线投屏接收端，通过 AirPlay 或 Google Cast 接收手机、平板和电脑画面，并支持多设备同时连接、高清镜像及会话录制，适合家庭娱乐、课堂教学、会议演示和应用展示。
Beamer 4是面向macOS的本地视频投屏工具，可将Mac中的影片投放到Apple TV、Chromecast及兼容设备，支持常见格式、多类字幕、环绕声、播放列表和电视遥控操作。
Boom 3D macOS版是一款系统级音效增强工具，可为音乐、电影、游戏和流媒体提供3D虚拟环绕声、31段均衡器、音量增强及应用独立音量控制，并支持本地播放器与多种音频输出设备。
Boris FX macOS版是一套面向剪辑、合成、调色及动态图形工作的专业后期工具，涵盖视觉特效、平面与三维跟踪、转描、画面修复、粒子动画和音频清理，可配合多种主流宿主软件使用。
Capto 是面向 macOS 的屏幕截图、高清录屏与媒体编辑工具，支持区域及整屏捕获、网页长截图、双音轨处理、图片和视频标注、素材分类与多渠道分享，适合教师、学生、内容创作者及需要制作演示教程的用户。
Cursor Crane 是一款仅面向 macOS 的键盘操控效率工具，可通过提示标签、网格、文字查找和窗口模式完成点击、滚动、定位与切换，并支持屏幕内容提取、脚本及工作流扩展。
Deep Freeze 冰点还原 macOS版通过冻结系统配置，让受保护的Mac在重新启动后回到预设状态，并提供解冻空间、维护计划、密码保护及Apple Remote Desktop管理能力。
Focusky macOS版是一款面向教学课件、商务汇报、产品展示和动画宣传内容的演示制作工具。它通过无限画布、路径编排、缩放旋转转场及多媒体编辑，将传统逐页幻灯片转化为更具空间感的动态演示。
Folder Colorizer 2 macOS版是一款直观的文件夹外观定制工具，可更换颜色，添加表情、贴纸及图片背景，并支持批量处理、智能推荐和恢复默认样式，帮助用户更快辨认工作、学习与生活资料。
AnyDesk Windows版是一款轻量化远程桌面与技术支持工具，可用于控制异地电脑、传输文件、远程打印及无人值守访问。它兼顾连接响应、安全权限和部署灵活性，适合个人远程办公、企业设备维护与客服支持。
Boom 3D Windows版是一款面向音乐、电影和游戏场景的系统级音效增强工具，支持虚拟3D环绕声、31段均衡器、预设音效、应用音量控制及本地音乐播放，可配合耳机、扬声器和蓝牙耳机使用。
Boris FX Windows版是一套服务于影视剪辑、视觉特效、运动跟踪、转描、图像修饰及音频修复的专业创作工具集合，可作为插件接入多种主流后期宿主，也包含可独立运行的应用，适合剪辑师、特效师与内容创作者使用。
ChemDraw Windows版是一款面向化学研究、药物研发、材料科学和教学工作的专业结构绘图工具，可快速绘制分子、反应式及生物聚合物，并提供结构整理、格式转换、性质计算和科研文档协作能力。
CODESOFT Windows版是一套企业级条码与RFID标签设计打印工具，可连接Excel、Access、SQL及云端数据源，支持变量、表单、GS1条码、数据库记录和多种工业打印机，适合制造、仓储、物流及合规标识场景。
Deep Freeze 冰点还原 Windows版通过重启恢复技术保护系统盘及指定分区，自动撤销恶意程序、误操作和配置漂移造成的改动，并支持密码保护、解冻空间与多硬盘管理，适合学校机房、公共电脑、办公终端及家庭电脑使用。
EDIUS 11 Windows版是一款面向影视制作、广播电视、纪录片、短视频及教育机构的专业非线性编辑工具，支持4K/8K、多格式混编、HDR调色、字幕、音频处理和后台渲染，并提供素材管理及丰富的导出预设。
FastStone Capture Windows版是一款轻量级屏幕捕捉、录屏与图像编辑工具，可截取窗口、区域、菜单和滚动页面，并提供标注、模糊、取色、OCR、录音录像及多格式导出能力，适合办公说明、教程制作和问题反馈。
Focusky Windows版是一款动画演示与交互课件制作工具，通过无限画布、缩放旋转镜头、模板素材和对象动画组织内容，可导入PPTX，并输出视频、EXE、PDF、网页等格式，适用于课堂教学、微课、商务汇报及产品展示。
Folder Colorizer 2 是面向 Windows 的文件夹颜色修改工具，可在资源管理器右键菜单中快速套用预设颜色，或通过 HEX 色值创建个性颜色，帮助用户直观区分项目、课程、素材与任务状态。
FumeFX Windows版是一款集成在3ds Max中的流体与多物理场特效插件，支持火焰、烟雾、液体、海洋、粒子及布料模拟，并提供GPU加速、节点化控制和缓存处理工具，适合影视、动画与游戏特效制作。
Fuzor Windows版是一套面向建筑、工程与施工团队的BIM/VDC平台，可汇集多来源模型和进度数据，完成实时可视化、4D施工推演、场地物流规划、问题检查、成果演示及团队协同。