composer require 是安装 SEO 工具包的起点，但关键在于选对包（如 artesaos/seotools 适合细粒度控制，romanzipp/laravel-seo 适合内容站）、正确发布并配置 config/seotools.php 中的 defaults、twitter.card、json-ld.use_html_entity_encode 等核心字段，并在 Blade 的 <head> 开头按顺序渲染元标签，且确保 SEOMeta::setTitle() 等调用在路由匹配后、视图渲染前动态执行，避免静态覆盖。
composer require 是解决网站 SEO 元数据管理问题最直接有效的手段——但不是装上就完事，关键在选对包、配对位置、用对时机。
为什么不能只靠手写 <meta> 标签？
硬编码元数据会导致三类实际问题：SEOTools::setTitle() 这类调用无法复用，不同页面逻辑混在一起；动态内容（如文章标题）需要 PHP 拼接字符串，极易 XSS 或闭合错误；多平台适配（Open Graph、Twitter Card、JSON-LD）各自维护一套逻辑，后期改一个字段要同步 4 处。
artesaos/seotools 和 romanzipp/laravel-seo 怎么选？
两者都支持 Laravel，但设计思路不同：
-
artesaos/seotools提供多个独立门面：SEOMeta、OpenGraph、TwitterCard、JsonLd，适合需要细粒度控制的项目，比如电商页要单独设og:price，而博客页要加article:published_time -
romanzipp/laravel-seo基于统一SEOData对象，所有字段集中设置，更适合内容型站点，控制器里只需传一个对象到视图，seo()->render($seoData)一行输出全部标签 - Laravel 11+ 用户注意：
artesaos/seotools的服务提供者注册已移至bootstrap/providers.php，不是旧版的config/app.php
配置文件发布后，哪些字段必须改？
运行 php artisan vendor:publish --provider="Artesaos\SEOTools\Providers\SEOToolsServiceProvider" 后，config/seotools.php 中这几个键值直接影响生成结果：
-
'defaults' => ['title' => '']：空字符串会触发 fallback，但建议填品牌主关键词，如'MyShop - 高品质蓝牙耳机' -
'twitter' => ['card' => 'summary_large_image']：不设此项，Twitter 默认用summary，图片不展示；设为summary_large_image才能显示大图卡片 -
'json-ld' => ['use_html_entity_encode' => false]：若页面含中文或特殊符号，保持false，否则中文这类编码会破坏 JSON-LD 结构，导致 Google Rich Results Test 报错
Blade 中 {!! SEOMeta::generate() !!} 放错位置会怎样？
常见错误是把它塞进 <body> 或放在 <head> 末尾。后果很具体：
- 放在
<body>内：浏览器会自动把<meta>移到<head>，但部分爬虫（如 Bingbot 早期版本）可能忽略 - 放在
<head>末尾且前面有<link rel="canonical">：某些 SEO 审查工具（如 Screaming Frog）会误判 canonical 优先级，认为它“被 meta 覆盖” - 正确做法：固定放在
<head>开头，紧贴<title>后，顺序为<title>→{!! SEOMeta::generate() !!}→{!! OpenGraph::generate() !!}→{!! TwitterCard::generate() !!}
真正容易被忽略的是动态上下文切换——比如用户访问 /products/123 时，SEOMeta::setTitle() 必须在路由匹配后、视图渲染前执行；如果在中间件里统一设默认标题，又没在控制器里覆盖，就会出现所有产品页标题一模一样。这不属于配置问题，而是执行时机问题。
