必须通过Git子模块方式嵌入laravel-devcontainer，执行git submodule add https://github.com/theomessin/laravel-devcontainer devcontainer；克隆时须用--recurse-submodules参数，否则devcontainer目录为空；VS Code需通过“Reopen in Container”或code --remote=dev-container .打开容器工作空间。
要在Laravel项目中复用标准化的开发环境配置（如laravel-devcontainer），又不污染主仓库历史和结构，必须通过Git子模块方式嵌入外部配置仓库。
添加laravel-devcontainer为子模块
在已存在的Laravel项目根目录下执行命令：
git submodule add https://github.com/theomessin/laravel-devcontainer devcontainer
这一步会把远程仓库以只读引用方式挂载到本地devcontainer目录，不会复制全部提交历史，也不会影响当前项目的.git文件结构。子模块路径必须是devcontainer，否则VS Code无法识别Dev Container配置。
执行后检查.gitmodules文件是否自动生成，并确认其中url和path字段值正确。
克隆含子模块的新项目
当你从零开始克隆一个已配置子模块的Laravel项目时，必须显式启用递归拉取：
git clone --recurse-submodules 【your-laravel-repo-url】
使用四维度框架评估任意 GitLab MR 或 GitHub PR 的复杂度：规模（20%），认知负荷（30%），审查工作量（30%），风险/影响（20%）...
如果漏掉--recurse-submodules参数，devcontainer目录将为空，且不会报错——这是最常被忽略的致命疏漏。后续手动执行git submodule update --init --recursive可补救，但首次克隆就带参是最稳妥的做法。
打开远程容器工作空间
方法一：VS Code图形界面操作
打开项目文件夹 → 点击左下角远程连接图标 → 选择“Reopen in Container”
方法二：命令行快捷方式
code --remote=dev-container .
注意：该命令仅在已安装Remote - Containers扩展且项目根目录存在.devcontainer/devcontainer.json时生效。若提示找不到配置，请先确认devcontainer目录非空且包含有效JSON配置文件。
