React Storybook初始化失败：npx sb init抛出is-arrayish模块缺失错误

问题场景 #

开发React组件库时，执行npx sb init初始化Storybook（自动安装sb@6.5.16版本），触发Node.js模块缺失错误，当前使用Node.js v18.14.2 LTS版本，完整报错信息：

Need to install the following packages:
  sb@6.5.16
Ok to proceed? (y)
node:internal/modules/cjs/loader:1078
  throw err;
  ^

Error: Cannot find module 'is-arrayish'
Require stack:
- C:\Users\hp\AppData\Local\npm-cache\_npx\d28cfb4b54958d89\node_modules\error-ex\index.js
- C:\Users\hp\AppData\Local\npm-cache\_npx\d28cfb4b54958d89\node_modules\parse-json\index.js
- C:\Users\hp\AppData\Local\npm-cache\_npx\d28cfb4b54958d89\node_modules\read-pkg\index.js
- C:\Users\hp\AppData\Local\npm-cache\_npx\d28cfb4b54958d89\node_modules\read-pkg-up\index.js
- C:\Users\hp\AppData\Local\npm-cache\_npx\d28cfb4b54958d89\node_modules\@storybook\cli\dist\cjs\generate.js
- C:\Users\hp\AppData\Local\npm-cache\_npx\d28cfb4b54958d89\node_modules\@storybook\cli\bin\index.js
    at Module._resolveFilename (node:internal/modules/cjs/loader:1075:15)      
    at Module._load (node:internal/modules/cjs/loader:920:27)
    at Module.require (node:internal/modules/cjs/loader:1141:19)
    at require (node:internal/modules/cjs/helpers:110:18)
    at Object.<anonymous> (C:\Users\hp\AppData\Local\npm-cache\_npx\d28cfb4b54958d89\node_modules\error-ex\index.js:4:18)
    at Module._compile (node:internal/modules/cjs/loader:1254:14)
    at Module._extensions..js (node:internal/modules/cjs/loader:1308:10)       
    at Module.load (node:internal/modules/cjs/loader:1117:32)
    at Module._load (node:internal/modules/cjs/loader:958:12)
    at Module.require (node:internal/modules/cjs/loader:1141:19) {
  code: 'MODULE_NOT_FOUND',
  requireStack: [
    'C:\\Users\\hp\\AppData\\Local\\npm-cache\\_npx\\d28cfb4b54958d89\\node_modules\\error-ex\\index.js',
    'C:\\Users\\hp\\AppData\\Local\\npm-cache\\_npx\\d28cfb4b54958d89\\node_modules\\parse-json\\index.js',
    'C:\\Users\\hp\\AppData\\Local\\npm-cache\\_npx\\d28cfb4b54958d89\\node_modules\\read-pkg\\index.js',
    'C:\\Users\\hp\\AppData\\Local\\npm-cache\\_npx\\d28cfb4b54958d89\\node_modules\\read-pkg-up\\index.js',
    'C:\\Users\\hp\\AppData\\Local\\npm-cache\\_npx\\d28cfb4b54958d89\\node_modules\\@storybook\\cli\\dist\\cjs\\generate.js',
    'C:\\Users\\hp\\AppData\\Local\\npm-cache\\_npx\\d28cfb4b54958d89\\node_modules\\@storybook\\cli\\bin\\index.js'
  ]
}

Node.js v18.14.2

解决方法 #

• 清理npm缓存：执行npm cache clean --force，清除缓存中可能损坏的依赖文件
• 使用最新版Storybook初始化：旧版本sb@6.5.16存在依赖兼容问题，改用命令npx storybook@latest init安装最新稳定版
• 切换Node.js版本：尝试切换到Node.js 16或20 LTS版本（用nvm管理：nvm install 20 && nvm use 20），避免版本兼容冲突
• 重置初始化环境：如果已生成部分.storybook文件，先删除该文件夹，清理缓存后重新执行初始化命令

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