Composer安装ThinkPHP应使用create-project而非require，它会生成完整项目结构；需配置APP_DEBUG=true、时区和runtime目录权限，否则框架静默失效。
Composer 安装 ThinkPHP 不需要单独“初始化 TP 框架”，一步到位，后续手动改配置才是关键。
用
直接拉取完整 TP 项目
ThinkPHP 是一个框架项目（不是纯库），不能靠
加到已有项目里——那样只会装个空壳，缺路由、入口、命令行工具等核心结构。
正确做法是：在空目录下运行
，它会自动下载骨架、安装依赖、生成
等标准目录
想指定版本？加版本号后缀，比如
（注意
和
行为不同，前者允许升级到
，后者只锁小版本）
如果卡在
或提示
，说明 Composer 正在从 GitHub 拉源码包——换国内镜像源可解：
（注意该镜像已停，推荐用
或阿里云源）
和
的本质区别
很多人在已有项目里跑
，结果 TP 不工作——因为
只读
装依赖，不生成项目结构；而
是“项目级初始化”，会执行
脚本，比如自动生成
目录、复制
。
如果你删了
想重装，应该用
（前提是已有
）
但如果你根本没运行过
，直接
会失败：缺少
中定义的 autoload 配置，
里的
会找不到文件
TP 8 的
默认启用了
，本地开发时可关掉（改成
），避免修改类后要反复跑
安装完必须改的三处配置
刚拉下来的 TP 默认是调试关闭、错误不显示、日志写入失败——你访问首页空白或 500，大概率卡在这几处。
Composer 2.9.6
Composer 2.9.6 是 PHP 生态中高效、稳定的依赖管理工具。此版本在性能与兼容性上进一步优化，改进了依赖解析算法，提升大型项目中的安装与更新速度。它支持并行下载任务，显著减少等待时间，并增强了与私有仓库及镜像源的交互稳定性。同时修复了多项命令行交互与内存使用相关的缺陷，确保在复杂依赖关系下依然可靠运行。无论是新项目初始化还是现有系统维护，Composer 2.9.6 都能为开发者提供流畅、精准的依赖管理体验。
下载
立即学习
“
PHP免费学习笔记（深入）
”；
改
：确保
，
，否则错误全被吞掉，连
都不出现
改
中的
，否则
、日志时间、缓存过期都可能错 8 小时
检查
目录权限：Linux/macOS 下 Web 服务器用户（如
或
）必须有写权限，否则模板编译、日志、缓存全挂；Windows 下一般没问题，但若用 Docker 则需映射并设好 uid/gid
真正麻烦的从来不是“怎么装”，而是装完发现
没开、
不可写、或者用了旧版 Composer 导致 autoload 生成异常——这些点不报具体错误，只让整个框架静默失效。
composer create-projectcreate-projectcomposer require topthink/thinkcomposer create-project topthink/thinkapp/public/composer create-project topthink/think:^8.0^8.08.0.*8.9.9Cloning into...github rate limitcomposer config -g repo.packagist composer https://packagist.phpcomposer.comhttps://packagist.laravel-china.orgcomposer installcreate-projectcomposer installinstallcomposer.lockcreate-projectpost-create-project-cmdruntime/.env.examplevendor/composer installcomposer.lockcreate-projectcomposer installcomposer.jsonindex.phprequire __DIR__.'/../vendor/autoload.php';composer.json"optimize-autoloader": truefalsecomposer dump-autoload.envAPP_DEBUG=trueLOG_LEVEL=debugWhoopsconfig/app.php'default_timezone' => 'Asia/Shanghai'date()runtime/www-data_wwwAPP_DEBUG=trueruntime/