大家都在问

来自读者留言与站内高频疑问，点开就是答案。

1. 01

   Astro 组件交互逻辑不生效是什么原因？

   默认组件是零 JS 的纯 HTML，必须在交互组件上加 client:* 指令（如 client:load、client:visible），否则脚本根本不会打包进页面。

   在指南里看完整配置 →
   同问
2. 02

   Tailwind v4 自定义品牌色不生效怎么办？

   颜色必须在 @theme 里声明（如 --color-brand），漏装 @tailwindcss/vite 或仍引用旧 config 都会让 bg-brand 静默不渲染。

   在指南里看完整配置 →
   同问
3. 03

   _headers / _redirects 为什么不生效？

   这两个文件必须放在输出目录根（如 dist/），放在 src/ 不会被下发；纯静态项目不要强加 _worker.js，否则失去零冷启动优势。

   在指南里看完整配置 →
   同问
4. 04

   canonical 与 sitemap 域名如何保持一致？

   两者都必须读 site.origin（Astro site 配置），硬编码域名在换域或 Preview 时会全部失效，被判重复页。

   在指南里看完整配置 →
   同问
5. 05

   批量生成的页面被判重复内容怎么破？

   每页必须有唯一 canonical、独立 title 与差异化正文；仅替换关键词、结构完全相同的页面要补真实差异，否则会被搜索引擎折叠。

   在指南里看完整配置 →
   同问
6. 06

   llms.txt 写全量长文为何被降权？

   AI 爬虫偏好摘要加规范 URL，铺满全量正文会判低质；llms.txt 只给地图，详情走落地页。

   在指南里看完整配置 →
   同问
7. 07

   FAQPage 结构化数据格式有什么硬性要求？

   每个 Question 必须配 acceptedAnswer，且问答真实可验证；编造答案会被 ChatGPT Search / Perplexity 降权。

   在指南里看完整配置 →
   同问
8. 08

   Vite manualChunks 配错会造成什么问题？

   写错会把样式误打进 JS 或造成循环依赖，首屏体积反升；应先按 vendor 粗拆，再逐步细化。

   在指南里看完整配置 →
   同问
9. 09

   Astro 哪个版本开始稳定支持 @tailwindcss/vite 集成？

   Astro 5 起官方推荐用 @tailwindcss/vite 插件替代旧 PostCSS 方案；升级前先锁定 astro 与 tailwind 主版本，避免 v3 配置被新插件忽略。

   在指南里看完整配置 →
   同问
10. 10

    Cloudflare 边缘节点缓存如何精准失效？

    静态资源用 immutable 加长 max-age，HTML 用 must-revalidate；改文件名即换 URL，Cloudflare 自动回源新版本。

    在指南里看完整配置 →
    同问
11. 11

    MCP Server 能同时用 stdio 和 HTTP 两种传输吗？

    不能，一个 Server 只能选一种传输。远程端点必须带 Bearer 鉴权，并把工具 scope 收到只读，否则等于把源码执行权限暴露在公网。

    在指南里看完整配置 →
    同问
12. 12

    把 MCP Server 部署到边缘，鉴权怎么做？

    远程 MCP 走带 Bearer 的 SSE 或 HTTP，工具只给只读权限；本地 stdio 不做网络暴露。两种传输不要塞进同一个 Server。

    在指南里看完整配置 →
    同问
13. 13

    Rust 编译的 WASM 在 Worker 里白屏，先查什么？

    多数是 wasm-bindgen 版本与运行时不匹配。锁死 wasm-pack 与 bindings 版本，构建前先跑一次冒烟测试。

    在指南里看完整配置 →
    同问
14. 14

    Next.js output: export 构建报错怎么办？

    用了动态路由的服务端取数或中间件都会导致导出失败；next/image 必须加 unoptimized，否则导出会中断。

    在指南里看完整配置 →
    同问
15. 15

    TypeScript 报循环依赖，怎么定位？

    开启 verbatimModuleSyntax 后，类型导入必须写成 import type，否则会被当成运行时依赖形成环。先收敛模块边界，再上 strict。

    在指南里看完整配置 →
    同问
16. 16

    Go 二进制换台机器就报依赖缺失？

    CGO 没关，产物依赖了目标机器上的 libc。构建时用 CGO_ENABLED=0 并静态链接，再按 GOOS / GOARCH 出包。

    在指南里看完整配置 →
    同问
17. 17

    同一个项目换 Bun 跑就报错，为什么？

    原生模块缺失，或部分 Node API 行为与 Node 不同。CI 必须锁 Bun 版本；老项目逐步迁移，新项目直接用 Bun 初始化。

    在指南里看完整配置 →
    同问