前端Storybook使用规范书.docVIP

前端Storybook使用规范书

一、Storybook环境搭建规范

1.版本选择与统一

项目中所有开发者必须使用相同版本的Storybook及其相关依赖，避免因版本差异导致的兼容性问题。版本号需在项目的package.json文件中明确锁定，例如：

{devDependencies:{@storybook/react:^7.6.17,@storybook/addon-essentials:^7.6.17,@storybook/addon-interactions:^7.6.17}}

版本选择应优先考虑稳定版，避免使用处于开发阶段的alpha或beta版本。如需升级版本，需由前端负责人组织进行充分测试，确认无兼容性问题后，统一在项目中进行升级。

2.项目结构配置

Storybook配置文件应统一放置在项目根目录下的.storybook文件夹中，核心配置文件包括main.ts和preview.ts。

main.ts：用于配置Storybook的基本参数，如stories路径、addons插件等。示例配置如下：

importtype{StorybookConfig}from@storybook/react-vite;constconfig:StorybookConfig={stories:[../src/**/*.