Astro 5.5.0 版本发布：样式脚本顺序控制与Markdown增强

Astro 是一个现代化的静态站点生成器，它结合了静态站点生成和动态渲染的优势，让开发者能够轻松构建高性能的网站。Astro 5.5.0 版本带来了几项重要的新功能和改进，主要集中在样式脚本顺序控制和Markdown处理方面。

实验性功能：保留脚本和样式顺序

在之前的版本中，Astro 会反转同一页面中多个 <style> 和 <script> 标签的顺序，这有时会导致意外的样式覆盖问题。5.5.0 版本引入了一个新的实验性标志 experimental.preserveScriptOrder，允许开发者控制这些标签的渲染顺序。

启用这个功能后，Astro 将按照标签在组件中定义的顺序生成样式和脚本。例如，如果你有以下组件：

<p>我是一个组件</p>
<style>
  body {
    background: red;
  }
</style>
<style>
  body {
    background: yellow;
  }
</style>

在默认情况下，Astro 会生成 yellow 样式在前，red 在后，最终应用 red 背景。而启用 preserveScriptOrder 后，顺序将保持不变，red 在前，yellow 在后。

这个功能可以通过以下配置启用：

import { defineConfig } from 'astro/config';

export default defineConfig({
  experimental: {
    preserveScriptOrder: true,
  },
});

Markdown 标题ID兼容性改进

Astro 5.5.0 还改进了 Markdown 标题ID的生成方式。默认情况下，Astro 会移除标题ID末尾的特殊字符后的连字符，这与常见的 Markdown 处理器行为不同。

新版本提供了 experimental.headingIdCompat 标志，允许开发者禁用这一行为，使生成的标题ID与 GitHub 和 npm 等平台保持一致：

import { defineConfig } from 'astro/config';

export default defineConfig({
  experimental: {
    headingIdCompat: true,
  },
});

如果你直接使用 rehypeHeadingIds 插件，也可以通过传递 experimentalHeadingIdCompat 选项来实现相同效果。

Markdown 语法高亮排除功能

对于使用 Markdown 代码块进行图表绘制的工具（如 Mermaid.js 和 D2），新版本增加了 excludeLangs 配置选项，允许开发者排除特定语言的高亮处理：

import { defineConfig } from 'astro/config';

export default defineConfig({
  markdown: {
    syntaxHighlight: {
      type: 'shiki',
      excludeLangs: ['mermaid', 'math'],
    },
  },
});

这样可以在不影响其他代码块高亮的情况下，避免与图表工具的渲染冲突。

其他改进和错误修复

1. 修复了内容文件保存时模式错误显示"未处理的拒绝"错误而非正确模式错误的问题
2. 修复了客户端路由器在使用自定义交换函数时可能执行脚本两次的边缘情况
3. 更新了 PrismJS 到 1.30.0 版本，增加了对新语言的支持并修复了安全问题
4. 修复了文档中关于 i18n 配置的错误描述
5. 解决了 astro:page-load 事件在所有脚本执行前触发的问题
6. 改进了当 sharp 未安装时的错误提示信息

这些改进使 Astro 在处理样式、脚本和 Markdown 内容时更加灵活和可靠，为开发者提供了更好的控制能力和更一致的行为。