composer install不能初始化ThinkPHP项目，因为它仅还原已有composer.lock声明的依赖，不创建项目骨架、入口文件或目录结构；空目录下执行会报“No composer.json found”，正确方式是先用composer create-project生成完整项目再运行install。
为什么composer install不能用来初始化ThinkPHP项目
因为composer install只还原已有composer.json或composer.lock声明的依赖，它不会创建项目骨架、入口文件、配置目录或public/结构。你在空目录下直接跑composer install，会立刻报错：No composer.json found in current directory。
正确做法是先用composer create-project topthink/think tp-demo生成完整项目，再进tp-demo目录运行composer install——此时它才真正起作用。
- 别在空目录或
public/子目录里执行composer install - 别把
composer.json从别人项目里复制过来就直接install——没composer.lock或版本不匹配，结果不可控 - TP 6+/7+ 不支持用
composer require topthink/think往空项目里“塞框架”，那只会拉个thinkphp/framework包，缺App类、缺think命令、缺public/index.php
composer install必须依赖composer.lock文件
生产环境所有机器上composer install的行为，完全由composer.lock决定，不是composer.json。你写"thinkphp/framework": "^6.0"，本地开发机装了6.0.12，但composer.lock没提交，测试机就可能装6.3.5——小版本差异足以让ClassNotFoundException或路由失效。
-
composer.lock必须提交到 Git，且不能加进.gitignore - CI/CD 部署脚本必须用
composer install --no-dev，禁用update，否则会忽略lock重新解析依赖树 - 执行前先确认
composer show thinkphp/framework输出是否三台机器完全一致（包括 patch 号）
常见错误：composer install后类找不到或白屏
这不是composer install失败，而是后续环节断了链。最常卡在三处：服务提供者没注册、配置文件没复制、自动加载没刷新。
立即学习“PHP免费学习笔记（深入）”；
- 检查
config/app.php中'providers'数组是否含扩展的服务提供者类，例如thinkcaptcha\CaptchaService::class - 手动复制
vendor/topthink/think-queue/config/queue.php到config/queue.php，否则运行时报Undefined index: type - 运行
composer dump-autoload -o重建映射，尤其当你改过composer.json里autoload段或新增了PSR-4命名空间 - Linux/macOS 下确保
runtime/可写：chmod -R 755 runtime/；Windows 下注意IIS/Apache运行账户权限
镜像源和PHP环境不匹配导致composer install卡住或失败
国内用户常因源不稳定或PHP扩展缺失，让composer install卡在“Resolving dependencies”或直接报could not find package。
- 先切阿里云镜像：
composer config -g repo.packagist https://mirrors.aliyun.com/composer/ - 确认PHP版本满足要求：TP 6.x ≥ 7.2，TP 7.x 强制 ≥ 8.1，运行
php -v验证 - 检查必需扩展是否启用：
openssl、mbstring、pdo、json——在php.ini里取消对应extension=行的注释 - Windows 下若提示
'php' is not recognized，说明PHP安装路径没加进系统PATH
真正麻烦的从来不是命令本身，而是composer.lock有没有被当成一等公民对待，以及runtime/和config/这两个目录是否始终处于“可写但没被污染”的状态。
