如何解决Gridsome.js执行create、develop命令时的报错问题？

核心问题根因 #

Gridsome已停止维护，对Node.js 17及以上版本兼容度极低，依赖包版本不匹配是报错的主要诱因。

可执行修复步骤 #

• 第一步：清理环境
  进入创建好的站点目录，删除node_modules文件夹、package-lock.json、yarn.lock三个文件/目录。
• 第二步：切换适配的Node.js版本
  通过nvm工具安装并切换至Node 14.x或16.x长期支持版本，执行命令：

  nvm install 16.20.2
  nvm use 16.20.2
  

• 第三步：重新安装依赖
  执行npm install完成依赖安装。
• 第四步：启动开发服务
  执行gridsome develop验证问题是否解决。

备选方案 #

如果上述步骤无效，可手动重装Gridsome CLI工具后重新创建项目：

1. 执行npm uninstall -g @gridsome/cli卸载全局CLI
2. 执行npm install -g @gridsome/cli重装最新正式版CLI
3. 重新执行gridsome create命令初始化项目

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