执行node index.js启动OpenPlatform时出现模块找不到错误求助

问题详情 #

按照OpenPlatform手动安装指引执行node index.js时出现模块找不到的错误，相关环境信息：

• 系统：Sonoma 14.2.1，终端使用zsh shell
• Node.js版本：v22.1.0，npm版本：10.7.0
• 已尝试执行npm install和npm install debug --save，问题未解决

错误输出 #

openplatform-master % node index.js           
> DEBUG PID: 66116 (v5)
ERROR ======= 2024-06-16 15:14:35: Error: Cannot find module '../openplatform-master/plugins/.DS_Store/index.js'
Require stack:
- ../openplatform-master/node_modules/total5/index.js
- ../openplatform-master/index.js
    at Module._resolveFilename (node:internal/modules/cjs/loader:1224:15)
    at Module._load (node:internal/modules/cjs/loader:1050:27)
    at Module.require (node:internal/modules/cjs/loader:1310:19)
    at require (node:internal/modules/helpers:179:18)
    at F.load (/openplatform-master/node_modules/total5/index.js:855:11) 
====================================================
PID           : 66117
Node.js       : v22.1.0
Total.js      : v5000
OS            : darwin 23.2.0
Memory        : 7.69 MB / 10.03 MB
User          : **
====================================================
Name          : OpenPlatform
Version       : 1.0.0
Date (utc)    : 2024-06-16 15:14:35
Mode          : debug
Compiled      : undefined files (0ms)
====================================================
Directory     : ../openplatform-master
node_modules  : ../openplatform-master/node_modules/
====================================================

这个错误是macOS自动生成的.DS_Store文件导致的：Total.js的OpenPlatform会尝试加载plugins目录下的所有子目录作为插件，而.DS_Store是macOS用于存储文件夹视图设置的隐藏文件，被误识别为插件目录，进而试图加载其中不存在的index.js文件。

解决步骤：

1. 删除plugins目录下的.DS_Store文件
   在终端进入openplatform-master/plugins目录，执行命令：

   rm .DS_Store
   

   或在访达中按Cmd + Shift + .显示隐藏文件，找到该文件后删除。

2. 防止后续自动生成.DS_Store文件
   执行以下命令禁止在网络存储目录生成该文件（对本地目录也有一定效果）：

   defaults write com.apple.desktopservices DSDontWriteNetworkStores true
   

3. 重新启动服务
   再次执行node index.js启动OpenPlatform，错误即可消除。

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