执行npm run storybook报错'start-storybook'不是内部或外部命令如何解决

该报错本质是系统无法找到start-storybook可执行文件，可按照以下步骤依次排查：

• 1. 切换执行路径到项目根目录
     你当前执行命令的路径为C:..project\src\features，属于项目子目录，必须切换到package.json所在的项目根目录再执行启动命令，否则npm无法读取项目本地依赖的可执行文件。
• 2. 确认Storybook依赖已正确安装
     适配React 17建议使用6.5.x版本的Storybook，先检查根目录package.json的devDependencies字段是否存在如下依赖：

  "@storybook/react": "^6.5.16",
  "@storybook/builder-webpack5": "^6.5.16"
  

  若缺失则执行安装：

  npm install @storybook/react@6.5.x @storybook/builder-webpack5@6.5.x --save-dev
  

• 3. 重装依赖避免文件损坏
     若依赖已存在仍报错，可能是之前安装的依赖文件有缺失，执行以下命令重装：

  # Windows环境可手动删除node_modules文件夹和package-lock.json文件
  rm -rf node_modules package-lock.json
  npm cache clean --force
  npm install
  

• 4. 验证启动脚本配置
     检查package.json的scripts字段是否配置正确：

  {
    "scripts": {
      "storybook": "start-storybook -p 6006"
    }
  }
  

  配置正确的前提下在项目根目录执行npm run storybook即可正常启动，若仍有问题可临时用npx调用本地可执行文件：

  npx start-storybook -p 6006
  

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