不能跳过composer直接放modules/contrib，因为模块的自动加载、依赖约束、钩子注册和插件发现均由composer的autoload和drupal-scaffold机制触发，手动复制会绕过这些机制，导致class not found、启用失败或后续update误删文件。
Composer 是 Drupal 9/10 唯一受支持的依赖管理方式，直接用 git clone 或手动上传模块已不被允许，且会导致更新失败、安全补丁无法应用、甚至站点崩溃。
为什么不能跳过 Composer 直接放 modules/contrib？
Drupal 9 起强制要求所有 contrib 模块必须通过 Composer 安装，原因很实在：模块的 autoloader、依赖约束（如 drupal/core 版本兼容性）、钩子注册和插件发现机制都由 Composer 的 autoload 和 composer.json 中的 extra.drupal-scaffold 触发。手动复制会绕过这些机制。
- 现象：模块出现在后台列表里但“启用”按钮灰掉，或启用后报
Class not found错误 - 根本原因：
vendor/autoload.php未加载该模块的命名空间，web/modules/contrib下的文件只是静态资源，不参与 PSR-4 自动加载 - 后果：后续
composer update会删掉你手动放进去的目录，且drush pm:enable可能静默失败
安装 Drupal 核心 + contrib 模块的正确命令链
从空项目开始，必须严格按顺序执行，否则 composer install 会因缺失 scaffold 配置而生成错误的 web 目录结构。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先创建项目骨架：
composer create-project drupal/recommended-project mysite—— 这会生成标准的web/入口目录和预设的composer.json - 再安装模块：
composer require drupal/views drupal/token—— 模块自动落到web/modules/contrib/，同时更新composer.lock和vendor/ - 切勿用
composer require drupal/<module-name>:^x.y</module-name>显式指定版本号，除非你明确知道该版本与当前drupal/core兼容；Composer 会自动解析满足约束的最新安全版本 - 安装后必须运行
drush en views token -y或在 UI 启用，仅composer require不会自动启用模块
混合镜像源配置失败的三个典型症状
国内团队常因镜像配置错误导致 composer require drupal/commerce 卡住、拉到旧版、或私有模块 404。关键不是 URL 对不对，而是 repositories 结构是否合规。
- 症状1：
composer require acme/private-module报Could not find package acme/private-module—— 检查repositories里是否漏了"type": "vcs"，且 URL 是 Git SSH/HTTPS 克隆地址（如https://gitlab.internal.acme.com/modules/private.git），不是网页链接 - 症状2：拉
drupal/core仍走 packagist.org，耗时超 30 秒 —— 确认"packagist.org": false是写在composer.json根层级，而非嵌套在repositories数组里 - 症状3：改完镜像后
composer update仍拉不到新包 —— 删除vendor/和composer.lock再重试；lock 文件会固化旧源地址，不删它就永远 fallback
Drupal Commerce 模块安装的特殊注意事项
drupal/commerce 不是普通 contrib 模块，它依赖大量 Symfony 组件和特定版本的 drupal/core，直接 composer require drupal/commerce 极易触发版本冲突。
- 务必先确认你的
drupal/core版本：Commerce 2.x 要求drupal/core:^9.5或^10.2，低于此版本会报your requirements could not be resolved - 推荐命令：
composer require drupal/commerce:^2.36（对应 Drupal 10.4），而不是不带版本号的composer require drupal/commerce - 安装后必须立即运行
drush cr，否则 Commerce 的实体类型、字段存储定义不会注册，后台“商店”“产品”菜单项不出现 - 别忽略
drush en commerce_product commerce_order commerce_checkout -y，Commerce 功能模块需显式启用，非全量安装
真正麻烦的从来不是命令本身，而是 composer.json 里一个逗号位置错了，或 vendor 目录残留了旧 lock 文件——这些细节不清理，再标准的流程也会卡在最后一步。
