直接迁移可行，但需避免vendor与代码同级耦合；停用旧autoload机制；配置composer.json的psr-4自动加载；逐步替换require为use；vendor不提交Git，composer.lock必须提交。
直接迁移是可行的，但关键在于避免把 vendor 目录和现有代码耦合进同一层级，否则后续更新、部署、自动加载都会出问题。
先确认当前项目是否已有自动加载机制
很多老项目用的是手动 require 或自定义 __autoload，这类逻辑必须停用，否则和 Composer 的 autoload 冲突，导致类找不到或重复定义。
- 搜索整个项目是否存在
__autoload函数或spl_autoload_register的全局注册 - 检查入口文件（如
index.php）里是否有大段require_once路径拼接逻辑 - 如果用了框架（如 CodeIgniter 2.x、Zend Framework 1），需查文档确认其 autoloader 是否兼容 PSR-4 —— 大部分不兼容，得关掉或替换
初始化 composer.json 并声明本地代码为 autoload 源
不能只写依赖，必须告诉 Composer 你自己的代码在哪、按什么规则加载，否则 require 进来的第三方包能用，你自己写的类依然报 Class not found。
{
"autoload": {
"psr-4": {
"App\": "app/",
"Core\": "core/"
}
},
"require": {
"monolog/monolog": "^2.10"
}
}
-
psr-4是首选，比classmap更轻量，也便于后续拆包 - 命名空间前缀末尾必须带反斜杠
，否则 Composer 会忽略 - 目录路径是相对于
composer.json所在位置的，不是绝对路径 - 改完后必须运行
composer dump-autoload，否则新规则不生效
逐步替换 require/require_once 为 use + new
硬编码路径的 require 是迁移最大障碍，不能一次性全删，得配合命名空间和自动加载逐步切。
- 先把一个模块（比如
app/Models/User.php）加上命名空间namespace AppModels; - 在调用处删掉
require_once 'app/Models/User.php';，换成use AppModelsUser;和$user = new User(); - 如果类里还引用了其他本地类，同样补
use，不要留require - 遇到第三方库（如自己写的
lib/Cache.php），可先用autoload.files加载一次，再逐步迁移到命名空间
部署时注意 vendor 不进 Git，但 composer.lock 必须提交
很多人把 vendor 提交到仓库，结果每次 git pull 后还要跑 composer install，其实白做了。
-
vendor/必须加进.gitignore，永远不提交 -
composer.lock必须提交，它锁定了所有依赖版本，保证多人环境一致 - 上线部署脚本里应包含
composer install --no-dev，而不是composer update - 如果服务器没装 Composer，用
composer install --no-dev --prefer-dist降低网络压力
最常被跳过的一步是：改完 composer.json 后忘记删掉旧的 autoloader 注册，或者没清 OPCache —— 类找不到的时候，先 php -d opcache.enable=0 your-script.php 排查，别急着重写 autoload。
