Composer安装Composer-installer指南
ComposerInstaller插件按框架规范安装第三方包到指定目录，需声明包的type字段，自定义路径仅支持{$name}和{$vendor}变量，拼写必须为installer-paths。残留包需手动删除目录后重装，与自动加载无关。
Composer Installer 这个插件，名字听着像“安装 Composer 的工具”，但千万别被它骗了。它的真正使命是：让第三方包，能按你项目的框架规范，准确落到该去的地方。换句话说，你装一个 WordPress 插件，它该去 wp-content/plugins/，而不是被扔进 vendor/ 里吃灰。这事儿，全靠它来张罗。
不过，很多人兴冲冲地 composer require composer/installers 之后，发现插件根本没按预期工作。问题出在哪儿？今天就一次性把几个最容易踩的坑说清楚。
你装了插件，但包没“搬家”？先查包的 type 字段写对没
这事儿太常见了。很多人以为只要本地装了 composer/installers，所有依赖就会自动“飞”到对应目录。其实，composer/installers 只是个“搬运工”，它不负责判断包该去哪，只负责执行搬运指令。而指令的来源，是你要安装的那个包自己声明的 type。
- 一个 WordPress 插件，必须在它的
composer.json里明确写"type": "wordpress-plugin"，搬运工才会把它搬到wp-content/plugins/。 - 如果它写的是
"type": "library"，或者干脆没写type，那不管你怎么折腾，它都会乖乖待在vendor/里。 - 验证方法很简单：装完后，先看看
vendor/下有没有这个包。如果没有，说明它被挪走了，再去目标目录（比如wp-content/plugins/）里找找看。
所以，别指望靠改自己项目的配置去“强制”一个未声明 type 的通用库进特定目录——它根本不会触发搬运逻辑。
自定义 installer-paths 时，路径变量写法最容易出错
这个坑也高发。很多人喜欢在 installer-paths 里玩花样，比如想加个版本号什么的。但这里有个硬性限制：它只支持 {$name} 和 {$vendor} 这两个变量插值，{$version} 是不认的。
- 正确写法：
"wp-content/plugins/{$name}/": ["type:wordpress-plugin"] - 错误写法：
"wp-content/plugins/{$name}-v{$version}/": [...]—— 这种写法{$version}不会被解析，最终要么生成空目录，要么直接报错。 - 路径结尾的斜杠
/不能省，否则 Windows 下可能因为路径分隔符问题导致创建失败。 - 多个规则写在数组里，顺序不重要，但匹配优先级由
composer/installers内部实现决定，不建议靠顺序来控制逻辑。
升级到 Composer 2.5+ 后配置失效？检查 key 名拼写
Composer 2.4 起，配置项还是叫 installer-paths（拼写没变），但很多人会误写成 installers-paths 或 install-path。这类拼写错误不会报错，只会静默忽略——你配了跟没配一样。
- 必须严格使用：
"installer-paths"（注意是installer，不是installers）。 - 完整结构示例：
{ "extra": { "installer-paths": { "wp-content/plugins/{$name}/": ["type:wordpress-plugin"], "app/Modules/{$name}/": ["type:lara vel-module"] } }} - 验证是否加载成功：运行
composer config extra.installer-paths，输出应为对应 JSON 对象；若为空，说明 key 写错了，或者没放在顶层extra下。
为什么 vendor/ 里还有包残留？composer dump-autoload 不管用
另一个常见误区：以为 composer dump-autoload 能重新排列包的位置。实际上，composer/installers 是“安装时”行为，跟自动加载完全无关。它只影响 composer install 或 composer update 时的文件落点。
- 残留在
vendor/里的包，通常是因为之前没配installer-paths，包已经下载到那了。新配完后，旧包不会自动搬走。 - 解决方法：手动删掉
vendor/xxx/yyy目录，再重新执行composer install或composer update xxx/yyy。 - 另外，如果一个包既出现在
installer-paths规则里，又出现在require列表中，它仍会被复制过去——installer-paths不阻止vendor/下存在副本，只是多建一份软链接或硬拷贝（取决于实现）。
总结一下，composer/installers 的核心逻辑很简单：你配好了、包也声明了，它才会乖乖干活。否则，一切都白搭。记住这一点，后面就不会再为“为什么没生效”而抓狂了。
Figma 是面向产品团队的界面与原型设计平台，Mac 客户端支持 Intel 和 Apple 芯片，可直接调用本机字体。它将矢量绘制、自动布局、组件库、交互原型、评论及多人实时编辑集中在统一工作区。
Final Cut Pro 是 Apple 面向 Mac 用户推出的专业视频剪辑软件，提供磁性时间线、媒体资源库、多机位剪辑、字幕生成、对象跟踪、调色、音频处理和多格式输出等工具。软件针对 Apple 芯片优化。
FreeCAD是一款免费开源的三维参数化建模软件，可通过草图、约束和特征历史构建尺寸精确且便于修改的模型。软件提供零件设计、装配、工程制图、建筑信息模型、有限元分析、数控加工及三维打印等工作台，并支持插件、宏和Python脚本扩展。
IntelliJ IDEA 是 JetBrains 推出的专业集成开发环境，重点服务于 Java、Kotlin 与 JVM 项目开发。软件集成代码补全、静态检查、重构、调试、测试、版本控制及构建工具，并可借助插件扩展语言和框架支持。
PhpStorm 是 JetBrains 推出的专业 PHP 集成开发环境，可在 Mac 上完成代码编写、智能检查、重构、调试、测试和数据库管理。它支持主流 PHP 框架、Composer、Git、Docker 与远程解释器。
JetBrains PyCharm 是面向 Python 开发者的集成开发环境，提供智能补全、代码检查、重构、调试、测试、版本控制及虚拟环境管理功能。Mac 版兼容 Intel 与 Apple 芯片，核心功能可免费使用。
JetBrains WebStorm 是面向 JavaScript、TypeScript 和现代 Web 技术的专业集成开发环境，可智能理解项目结构，提供代码补全、重构、错误检查、运行调试、测试及 Git 工具。
Logic Pro 是 Apple 为 Mac 打造的专业音乐制作软件，集音频与 MIDI 录制、编曲、节拍制作、采样、混音和母带处理于一体。它提供丰富的软件乐器、效果插件、声音资源以及智能创作工具。
Navicat Premium 是适用于 Mac 的一体化数据库开发与管理工具，可在统一界面中连接 MySQL、PostgreSQL、MongoDB、MariaDB、SQL Server、Oracle、SQLite、Redis 和 Snow
Pixelmator Pro 是 Apple 面向 Mac 用户提供的专业图像编辑与视觉设计软件，集照片调色、对象移除、图层合成、蒙版、矢量绘图、文字排版和数字绘画于一体。软件深度利用 Apple 芯片、Metal 与系统服务。
Postman是一套面向API全生命周期的开发与测试平台，可在Mac上发送和调试多种协议请求，管理集合、环境及认证信息，并完成脚本测试、模拟服务、监控、文档发布和团队协作。它适合开发、测试及运维人员使用，提供个人免费方案。
Pro Tools 是 Avid 推出的专业数字音频工作站，覆盖多轨录音、无损剪辑、MIDI 编曲、插件处理、自动化混音及声音与画面同步等工作。它拥有 Intro、Artist、Studio 和 Ultimate 等方案。
Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件，支持 Windows、macOS 和 iPad 等平台，广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件，集建模、动画、渲染、视频编辑与视觉合成等功能于一体，广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎，并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统，安装包轻巧、运行流畅，依托活跃的全球开发者社区持续更新，是从初学者到专业创作者都值得选择的正版 3D 创作工具。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。