求助：AdminJS运行报错Cannot find module '@adminjs/design-system'

1. 修正模块引用路径 #

你当前使用的相对路径引用是错误的，npm安装的包无需本地路径引用，直接使用包名即可：

const AdminJSDesignSystem = require('@adminjs/design-system');

如果项目使用ES模块语法，改用：

import AdminJSDesignSystem from '@adminjs/design-system';

2. 解决重装依赖时的报错 #

若重新安装依赖出现大量报错，按以下步骤排查：

• 清理npm缓存：

  npm cache clean --force
  

• 删除项目根目录下的node_modules文件夹和package-lock.json（使用yarn则删除yarn.lock）
• 检查Node.js版本是否符合AdminJS及design-system的要求（建议使用LTS版本，如16.x或18.x）
• 重新安装所有依赖：

  npm install
  

  若npm安装仍有问题，尝试用yarn替代：

  yarn install
  

3. 检查依赖版本兼容性 #

确保@adminjs/design-system的版本与AdminJS主版本兼容，可直接安装对应匹配版本：

npm install @adminjs/design-system@<兼容版本号>

例如AdminJS为6.x版本时，安装对应design-system版本：

npm install @adminjs/design-system@^6.0.0

4. 确认依赖已正确注册 #

检查项目根目录的package.json文件，确认dependencies中存在@adminjs/design-system，若缺失则手动添加并安装：

npm install @adminjs/design-system --save

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