Composer 不提供命名空间批量替换功能，需手动更新 composer.json 的 autoload 配置、重命名目录、用 sd 或 PowerShell 批量替换 namespace 和 use 语句，并执行 dump-autoload 验证。
Composer 本身不提供命名空间批量替换功能
Composer 是依赖管理工具，不是代码重构工具。它不会解析 PHP 文件、修改 namespace 声明或更新 use 语句。所谓“用 Composer 修改命名空间”，实际是误传——你真正需要的是在 Composer 管理的项目中，配合外部工具完成命名空间迁移，并让 autoload 配置同步生效。
先改 composer.json 的 autoload 和 autoload-dev
这是最易被跳过的一步，但直接决定后续类是否能被自动加载。若只改文件内容不更新配置，新命名空间会 500 报 Class not found。
-
"psr-4"映射必须与新命名空间前缀一致，例如从"App\"改为"MyCompany\Blog\"，对应目录也要重命名（如app/→src/） - 别忘了检查
"classmap"或"files"中是否硬编码了旧命名空间路径 - 执行
composer dump-autoload -o强制重建优化后的 autoloader，否则改动不生效
用 sed 或 ripgrep + sd 批量替换 PHP 文件中的命名空间
Linux/macOS 下推荐 sd（比 sed 更安全，支持 `-i` 原地替换且默认跳过二进制文件），Windows 用户可用 PowerShell 的 Get-ChildItem -Recurse -Include "*.php" | ForEach-Object { (Get-Content $_.FullName) -replace 'old', 'new' | Set-Content $_.FullName }，但务必先备份。
- 基础命令示例（替换全局
namespace App;为namespace MyCompany\Blog;）：sd 'namespaces+App;' 'namespace MyCompany\Blog;' src/**/*.php
- 必须转义反斜杠：PHP 命名空间中的
在正则里要写成\，否则匹配失败 - 别漏掉
use语句和字符串内硬编码（如日志上下文、配置键），这些需人工核对，sd无法智能判断语义 - 运行前加
--dry-run（如果工具支持）或先在小范围测试
验证时重点看 composer validate 和类加载行为
很多人改完就跑 php artisan serve 或直接部署，结果在某个边缘路由才暴露问题。
- 执行
composer validate --strict检查composer.json格式及 autoload 路径是否存在 - 用
composer show --path MyCompany\Blog\SomeClass确认类路径解析正确（需先dump-autoload） - 写个最小测试脚本：
<?php require_once 'vendor/autoload.php'; var_dump(class_exists('MyCompany\Blog\Http\Controllers\PostController'));，避免被框架缓存误导 - IDE（如 PHPStorm）的“Rename Namespace”功能虽方便，但它依赖索引，可能漏掉动态拼接的命名空间字符串——这类必须手动扫
改命名空间本质是项目结构升级，不是配置开关。最常出问题的地方不在工具链，而在没同步更新 tests 目录下的 use、Laravel 的 config/app.php 中的 providers 数组、或者 Doctrine 实体映射里的 @ORMTable 注解。动手前先 git status 确保工作区干净，改完立刻 git diff 过一遍所有变更。
