升级Laravel及eloquent-docs后Carbon命名空间生成错误求助

这不是你的操作错误，而是sethphat/eloquent-docs v2.0.1版本在处理Carbon命名空间时的行为变更或bug，导致使用--short-class参数生成的PHPDoc没有添加全局命名空间的前置反斜杠。

以下是几种解决思路：

• 检查命令参数或配置
  查看该包的最新文档，确认是否新增了控制命名空间输出的参数。比如是否有--full-namespace类的选项，可以覆盖--short-class对全局类的命名空间处理逻辑，强制生成带前置反斜杠的\Carbon\Carbon。

• 临时批量修复
  用脚本批量修正生成的模型文件中的PHPDoc，比如使用sed命令：

  sed -i 's/@property Carbon\\Carbon/@property \\Carbon\\Carbon/g' app/Models/*.php
  

  注意Windows环境下sed命令可能需要调整，或者用PowerShell的替换命令。

• 向包仓库提交Issue
  前往该包的代码仓库提交问题，说明在Laravel 11环境下，使用--short-class参数生成日期属性PHPDoc时，Carbon命名空间缺失前置反斜杠，导致IDE解析为App\Models\Carbon\Carbon的错误情况，并附上新旧版本的生成结果对比，帮助开发者定位修复。

• 临时降级包版本
  如果需要立即恢复正常使用，可以将包降级到之前的稳定版本，修改composer.json中的版本约束：

  "sethphat/eloquent-docs": "^1.x"
  

  然后执行composer update sethphat/eloquent-docs完成降级。

内容的提问来源于stack exchange，提问作者Symfony TestMail