Composer命令必须在Drupal项目根目录（含composer.json和web/）运行，错一层会导致模块安装路径错误、Drush无法识别；drupal/前缀决定模块存放位置，漏写会报错；升级核心需谨慎约束版本，避免不兼容。
Composer命令该在哪个目录运行
必须在 Drupal 项目的根目录（即包含 composer.json 和 web/ 或 docroot/ 的那一层）执行所有 composer 命令。不是在 web/ 下，也不是在 modules/ 里——错一层，composer install 就会装错位置，模块进不了 web/modules/contrib/，Drush 也扫不到。
- 典型正确路径：
/var/www/my-drupal-site/composer.json（同级有web/） - 如果用的是 Drupal 9+ 官方推荐结构，
vendor/和composer.lock必须和composer.json同级，不能嵌套 -
cd web && composer require drupal/pathauto是常见错误：这会让 Composer 把包装进web/vendor/，Drupal 根本不认
require drupal/foo 和 require foo/bar 的区别
Drupal 模块分两类来源：官方 drupal.org 托管的（用 drupal/xxx 命名），和通用 PHP 包（如 symfony/http-foundation）。Composer 不会自动识别哪类该放哪——全靠你写对包名前缀。
-
composer require drupal/views→ 自动下载到web/modules/contrib/views/（前提是启用了drupal-composer/drupal-project类型的插件） -
composer require phpunit/phpunit→ 装进vendor/，只供 CLI 测试用，不影响 Drupal 运行时 - 漏写
drupal/前缀（比如写成composer require views）会报错：Package views not found
composer update 为什么总崩在 drupal/core
composer update drupal/core 不是“升级 Drupal”，而是按 composer.json 里写的约束拉取新版本——如果约束太松（比如 "drupal/core": "^9"），它可能直接跳到 10.x，而你的模块还没适配，站点立刻白屏。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 安全更新建议用：
composer update drupal/core --with-dependencies，但先确认composer.json里drupal/core的版本约束锁死了小版本，例如"^9.5"而非"^9" - 升级大版本（如 9→10）必须手动改
composer.json，再跑composer update，不能指望一条命令全自动 - 执行后若出现
Class 'DrupalCoreRenderRendererInterface' not found，大概率是核心和 contrib 模块版本不匹配，得查对应模块的drupal/core兼容声明
vendor/autoload.php 加载失败或模块不生效
Drupal 8+ 依赖 Composer 的自动加载机制，但它的入口不是直接 include vendor/autoload.php，而是通过 web/autoload.php 中转——这个文件由 Drupal 安装器脚本生成，一旦缺失或损坏，整个自动加载链就断了。
- 删掉
vendor/后重装，务必运行composer install（不是update），否则web/autoload.php可能不重建 - 检查
web/index.php开头是否包含：require_once __DIR__ . '/../autoload.php';—— 如果指向错了路径（比如写成../vendor/autoload.php），就会绕过 Drupal 的加载逻辑 - 模块启用后提示
Class not found，先运行drush cr，再检查vendor/composer/autoload_psr4.php里有没有对应命名空间映射（例如"Drupal\views\": ["web/modules/contrib/views/src/"]）
最麻烦的其实是 composer.json 里混用了不同项目模板的配置项，比如把 drupal/recommended-project 的 installer-paths 和旧版 drupal-composer/drupal-project 的写法叠在一起，autoload 规则互相覆盖，这种问题不会报错，但模块就是不动。
