Storybook v8.4.2自定义故事排序不生效，请求排查配置问题

你遇到的问题来自两个配置细节错误：

1. 排序方法优先级冲突 #

你设置了method: 'alphabetical'，这会让Storybook优先按字母顺序排序顶级分类——TOKENS以T开头，自然排在以C开头的COMPONENTS前面，直接覆盖了你自定义的order顺序。必须将method改为'custom'，才能启用你定义的自定义排序规则。

2. 子项排序的嵌套语法错误 #

你把COMPONENTS的子项排序规则单独写在order数组里，不符合Storybook的嵌套配置语法。正确写法是把COMPONENTS的子规则嵌套在它自身的数组项中。

修正后的preview.js配置 #

{
    // actions: { argTypesRegex: "^on[A-Z].*" },
    controls: {
        matchers: {
            color: /(background|color)$/i,
            date: /Date$/,
        },
        expanded: true,
    },
    options: {
        storySort: {
            method: 'custom', // 改为custom启用自定义顺序
            includeNames: true,
            order: [
                'COMPONENTS',
                // 嵌套子规则：COMPONENTS下的所有分类，每个分类里Docs排最后
                [
                    '*', 
                    ['*', 'Docs']
                ],
                'TOKENS',
                'PAGES',
            ],
        },
        selectedPanel: 'storybook/controls/panel'
    }
}

效果说明 #

修正后，顶级分类会严格按照你要求的COMPONENTS → TOKENS → PAGES顺序排列；同时COMPONENTS下每个子分类里的"Docs"故事都会自动排到该分类的最后位置，多层嵌套的结构也能适用这个规则。

内容的提问来源于stack exchange，提问作者Boguz