Astro集成HTML教程，传统页面嵌入指南

Astro 为传统 HTML 页面提供了极简集成方案——只需将 .html 文件放入 `src/pages/` 目录，即可零配置原样输出，不编译、无 hydration、无 JS 注入，真正实现“所写即所得”；但这份自由也伴随着严格约束：内联脚本和样式不隔离、不优化，不支持 `import`，无法使用 Astro 的岛屿架构或 scoped CSS，且插入动态 HTML 必须通过 `set:html` 并严防 XSS；它不是现代组件的替代品，而是一个需谨慎使用的“逃生舱”——适合静态页面快速迁移，却要求开发者主动承担作用域管理、样式冲突与脚本污染的风险。

直接用 .html 后缀文件就能写纯 HTML

Astro 默认支持 .html 文件作为页面路由，不需要任何配置。把传统 HTML 页面丢进 src/pages/ 目录下，比如 src/pages/about.html，Astro 就会原样输出它，不编译、不注入 JS、不加 hydration —— 真的就是你写的什么，浏览器就收到什么。

常见错误现象：404 找不到页面，往往是因为文件没放对位置（必须在 src/pages/ 或其子目录），或者用了 .astro 后缀却只写了 HTML 标签（.astro 文件要求至少有一个顶层组件或 ）。

• 路径必须是 src/pages/xxx.html，不是 public/（那是静态资源，不走路由系统）
• HTML 文件里可以写