COMPOSER_VENDOR_DIR用于自定义Composer依赖安装路径，支持通过环境变量或composer.json配置修改vendor目录位置，适用于特殊项目结构、共享依赖或部署需求，需确保目录可访问且自动加载路径正确，推荐优先在composer.json中配置以保证团队一致性。

COMPOSER_VENDOR_DIR 是 Composer 提供的一个环境变量，用于自定义 vendor 目录的路径。默认情况下，Composer 会把项目依赖安装到项目根目录下的 vendor 文件夹中。通过设置 COMPOSER_VENDOR_DIR，你可以改变这个目录的位置。

作用说明

COMPOSER_VENDOR_DIR 的主要作用是控制 Composer 安装依赖包（如框架、库等）的目标目录。当你运行 composer install 或 composer update 时，Composer 会将所有第三方包下载并解压到该变量指定的路径下。

这在以下场景中非常有用：

• 项目结构特殊，希望将 vendor 放在非标准位置
• 多个项目共享同一个 vendor 目录（需谨慎使用）
• 测试不同版本依赖时隔离环境
• 某些部署或构建流程需要依赖存放在特定目录

使用方法

可以通过以下几种方式设置 COMPOSER_VENDOR_DIR：

1. 命令行临时设置（推荐用于调试）

COMPOSER_VENDOR_DIR=/path/to/custom/vendor composer install

这条命令只在当前执行中生效，不会影响其他调用。

2. 环境变量全局设置（Linux/macOS）

export COMPOSER_VENDOR_DIR="/my/own/vendor" composer install

此后所有 Composer 命令都会使用这个目录，直到环境变量被取消。

windows-screenshot-ocr

Windows全屏截图（自动标记鼠标位置）+ 原生OCR文字识别。本地运行，无需联网和API Key，适用于截图分析和自动化OCR场景。

下载

3. Windows 系统设置环境变量

set COMPOSER_VENDOR_DIR=C:\project\libs composer install

或在系统环境变量中添加，实现持久化。

4. 在 composer.json 中配置（更推荐的方式）

虽然环境变量可以控制路径，但更规范的做法是在 composer.json 中使用 config 字段：

{ "config": { "vendor-dir": "custom/path/vendor" } }

这种方式比环境变量更明确，且能随项目共享。

注意事项

使用 COMPOSER_VENDOR_DIR 时需要注意：

• 指定的目录必须存在或可创建，否则 Composer 会报错
• 更改路径后，自动加载器（autoload）也会基于新路径生成，确保引入 autoload.php 时路径正确
• 如果团队协作，请优先使用 composer.json 配置而非环境变量，避免因环境差异导致问题
• 某些插件或脚本可能硬编码 vendor 路径，移动后需检查兼容性

基本上就这些。合理使用 COMPOSER_VENDOR_DIR 可以灵活管理依赖存储位置，但建议仅在必要时自定义，保持项目结构清晰。