在macOS ARM版本下修复HBuilderX启动错误与依赖问题

在使用 macOS ARM 版本的 HBuilderX 时，遇到 Cannot find module 错误和 SCSS 编译问题并不罕见。通过升级 Node.js、调整 SCSS 配置或重新安装依赖项，可以有效解决这些问题。对于一些特别的兼容性问题，选择回退到 Intel 版本的 HBuilderX也是一种可行的方案

解决思路：

1. node版本选择在20或以上 （建议nvm多版本管理,方便快捷）
2. 重新安装有些插件的依赖
3. 全局安装yarn

错误提示 LanguageServerIndex

The LanguageServerIndex server crashed 5 times in the last 3 minutes.  The server will not be restarted.

解决办法:
进入/Applications/HBuilderX.app/Contents/HBuilderX/plugins/hbuilderx-language-services/目录
删除 node_modules 目录
再执行 yarn install 安装缺失的依赖项。
语言服务的话nodejs版本低于20的话会安装依赖失败

错误提示 Cannot find module mime.js

提示信息如下：

ERROR Error: Cannot find module '/Applications/HBuilderX.app/Contents/HBuilderX/plugins/uniapp-cli/node_modules/mime/mime.js'. Please verify that the package.json has a valid "main" entry.

解决办法：
进入目录 /Applications/HBuilderX.app/Contents/HBuilderX/plugins/uniapp-cli/ 执行yarn install安装依赖即可

错误提示 node-sass 更换为 dart-sass

hbuilderX报错 Vue2 scss 预编译器默认已由 node-sass 更换为 dart-sass，如果您的代码使用了 dart-sass 不支持的旧语法，可能存在部分不兼容的问题。

由于 dart-sass 不支持某些旧的 SCSS 语法，如果你的项目使用了这些语法，可以考虑将代码调整为 dart-sass 支持的语法。具体的语法调整可以参考 UniApp 官方文档。

如果你希望继续使用 node-sass，可以在 manifest.json 中添加以下配置：

"sassImplementationName": "node-sass"

但是，针对 ARM 版本的 HBuilderX，修改配置后可能仍然无法解决问题。这时，可以考虑切换到 Intel 版本的 HBuilderX

版权声明：本文为原创文章，版权归 全栈开发技术博客 所有。

本文链接：https://www.lvtao.net/tool/macos-arm-hbuilderx-error-fix.html

转载时须注明出处及本声明