<p>Composer install 总装错 ThinkPHP 版本，因 composer.json 未锁死 thinkphp/framework 版本或使用 ^/~ 宽松约束，导致安装非预期小版本；生产环境须用精确版本、提交 composer.lock、禁用 dev- 分支、部署用 install --no-dev 并验证 autoload。</p>
Composer install 为什么总装错 ThinkPHP 版本
因为 composer.json 里没锁死 thinkphp/framework 的版本，或者用了 ^、~ 这类宽松约束。Composer 默认按语义化版本规则找“最新兼容版”，比如写 "thinkphp/framework": "^6.0"，它可能装 6.3.5 而不是你本地测试过的 6.0.12 —— 表面能跑，但中间某个小版本悄悄改了钩子调用顺序或配置合并逻辑，上线就报 ClassNotFoundException 或路由不生效。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 生产环境的
composer.json必须用精确版本，例如："thinkphp/framework": "6.0.12"，别带^、~、* - 执行
composer install前，先确认当前目录下有composer.lock文件且已提交到 Git —— 它才是真实安装依据，composer.json只是“意向书” - 如果团队共用一个项目但有人运行了
composer update，lock 文件会被重写，立刻 revert 并全员重新composer install
composer.lock 文件被忽略导致环境不一致
很多人把 composer.lock 加进 .gitignore，觉得“依赖文件不用管”，结果开发机装的是 topthink/think-swoole v3.1.4，测试机却拉到 v3.2.0，后者要求 PHP 8.1+，直接报 ParseError: syntax error。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
-
composer.lock必须提交到 Git，这是 ThinkPHP 多环境一致的唯一强保障 - CI/CD 流水线中，部署脚本必须用
composer install --no-dev（而非update），否则会绕过 lock 文件重新解析依赖树 - 检查现有项目：运行
composer show thinkphp/framework，再对比开发/测试/生产三台机器输出是否完全一致（包括 patch 版本号）
dev-master 或分支名在 composer.json 中的危险性
为“尝鲜”或“等某个 PR 合并”，有人在 composer.json 写 "thinkphp/framework": "dev-develop" 或 "dev-master"。这等于告诉 Composer：“每次 install 都去 GitHub 拉最新 commit”，不仅慢，而且无法回滚 —— 某天 develop 分支合入一个破坏性变更，所有新部署实例全挂。
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 绝对禁止在生产或预发布环境使用
dev-开头的版本约束 - 如真需特定未发版功能，用
commit-hash锁定，例如："thinkphp/framework": "dev-develop#abc1234"，但要清楚这等于手动维护补丁 - 定期检查
composer show --outdated，只升级经过 QA 验证的小版本，跳过大版本（如 6.x → 7.x）
vendor 目录权限与 autoload 生效问题
有些服务器上 composer install 成功，但访问页面报 Class 'think\App' not found。常见原因是 vendor 权限太严（比如 700），或 autoload_psr4.php 生成失败（因磁盘满、SELinux 限制、用户切换导致路径写错）。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 部署后立即运行
php think optimize:autoload，强制重刷 autoload 映射，比删 vendor 重装更快更准 - 确认
vendor/autoload.php被入口文件正确引入，且该文件可读（ls -l vendor/autoload.php） - 若用 Docker，注意宿主机和容器内 UID/GID 不一致可能导致 vendor 下文件属主异常，加
--uid=1001 --gid=1001参数或统一用非 root 用户构建
最麻烦的不是锁版本，而是以为锁了——结果 composer.lock 没提交、install 被误写成 update、或者某台机器的 Composer 缓存里躺着旧包。这些地方一漏，前面所有版本控制都白做。
