使用Vue CLI创建项目报uv_os_gethostname returned ENOSYS错误如何解决

报错场景 #

执行创建Vue项目命令：

D:\> vue create crud-app

终端抛出如下错误：

node:os:68
        throw new ERR_SYSTEM_ERROR(ctx);
        ^

SystemError [ERR_SYSTEM_ERROR]: A system error occurred: uv_os_gethostname returned ENOSYS (function not implemented)
     at new Defaults (C:\node32\node_modules\@vue\cli\node_modules\@achrinza\node -ipc\entities\Defaults.js:26:20)
     at new Parser (C:\node32\node_modules\@vue\cli\node_modules\@achrinza\node-i pc\entities\EventParser.js:8:14)
     at Object.<anonymous> (C:\node32\node_modules\@vue\cli\node_modules\@achrinza\node-ipc\dao\client.js:11:19) 

终端报错截图：

报错根因 #

该错误由Node.js版本与Vue CLI依赖的@achrinza/node-ipc包不兼容导致：从报错路径可以看出当前使用的是32位Node.js环境，18/20及以上版本的高版本Node搭配旧版本Vue CLI时，node-ipc调用系统接口查询主机名的逻辑会触发函数未实现的系统错误。

解决方法 #

按优先级从高到低操作即可：

• 更换兼容的Node.js版本：卸载当前32位Node.js，安装Node.js 16.x LTS 64位稳定版本，安装完成后重启终端，执行node -v确认版本输出正确后，重新运行项目创建命令即可。该版本和Vue CLI 5.x的依赖匹配度最高，是最稳妥的解决方案。
• 升级全局Vue CLI版本：如果不想更换现有Node环境，直接执行npm install -g @vue/cli@latest将全局安装的Vue CLI升级到最新版本，新版Vue CLI已经替换了存在兼容问题的node-ipc依赖版本，升级完成后执行npm cache clean -f清空npm缓存，再重试创建命令。
• 配置环境变量临时绕过报错：打开Windows系统环境变量设置面板，新增一个名为HOSTNAME的系统变量，变量值可随意填写（例如local-dev），保存配置后重启终端再执行创建命令，即可跳过触发报错的系统主机名查询逻辑。

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