composer require 初始化空项目会自动创建 composer.json，生成最小可用配置并支持后续依赖管理。

直接用 composer require 初始化空项目

没有 composer.json 时，composer require 不会报错，而是自动创建它。这是最常用也最安全的起点——别先手写 composer.json，也别用 composer init 一步步填表。

• 执行 composer require monolog/monolog，Composer 会自动生成最小可用的 composer.json（含 require 和默认 autoload）
• 如果项目已有 vendor/ 但没 composer.json，先删掉 vendor/ 再运行 require，否则可能因锁文件缺失或版本冲突失败
• 不建议用 composer create-project，它默认拉完整骨架，和“临时引入依赖”场景不匹配

composer.json 自动生成后要注意的字段

生成的文件极简，但两个字段容易被忽略，直接影响后续使用：

Node.js 可靠编程

Node.js 可靠编程技能。避免事件循环阻塞、异步陷阱、ESM 兼容问题和内存泄漏。触发词：Node.js 开发、async/await、流处理、性能优化、安全编码。

下载

• "type": "project" 是默认值，不用改；但如果你打算把这项目当包发布，得手动加 "name"（格式如 "acme/temp-script"），否则其他项目无法通过 require 引用它
• "autoload" 默认为空对象 {}，意味着你写的 PHP 文件不会被自动加载——若要 require 自己的类，必须补上 "psr-4": {"App\": "src/"} 并建好 src/ 目录
• 生成的 composer.lock 会锁定依赖版本，但首次运行时若网络不稳定，可能只写入部分哈希，导致下次 install 失败；遇到 file could not be downloaded，删掉 composer.lock 重试即可

临时脚本场景下绕过 autoload 的快捷写法

纯 CLI 脚本、一次性数据处理任务，不需要 PSR-4 自动加载，只想快速用上某个包？

• 执行 composer require symfony/var-dumper --no-autoloader，它不会往 composer.json 写 autoload 字段，也不会生成 vendor/autoload.php 的加载逻辑
• 但依赖仍会下载到 vendor/，你只需手动 require 'vendor/autoload.php';（只要没加 --no-autoloader，这个文件就存在）
• --no-autoloader 真正适用的场景极少，多数人误以为它能“轻量”，其实只是省了一行配置；反而容易忘记手动加载，结果报 Class not found

Windows 下路径权限与缓存引发的静默失败

在 Windows 上用 CMD 或 Git Bash 执行 composer require 时，没报错但 vendor/ 没生成，或生成后文件全空——大概率是 Composer 缓存损坏或临时目录无写权限。

• 先运行 composer clear-cache，再试 require
• 检查 %LOCALAPPDATA%Composeriles 是否被杀毒软件锁定；临时关闭实时防护再试
• 避免在 OneDrive 同步目录或带中文路径的文件夹里初始化，Composer 会因路径编码问题跳过某些解压步骤，现象是 vendor/monolog/monolog 目录存在但内部为空

依赖管理的核心不是文件有没有，而是 composer.json 和 composer.lock 是否成对、可复现。空项目第一次 require 后，立刻 git add composer.json composer.lock——后面所有问题，基本都源于这两份文件的不一致或缺失。