启动NativeScript Sidekick遇primordials未定义错误求解决方案

你遇到的这个问题是典型的Node.js版本与NativeScript旧版CLI依赖不兼容导致的，我来给你说具体的解决办法：

问题复现与原因分析 #

启动NativeScript Sidekick（版本1.16.2-v.2019.3.13.12）时，Windows弹出异常，输出面板抛出如下错误：

(node:6632) UnhandledPromiseRejectionWarning: ReferenceError: primordials is not defined
    at fs.js:27:35
    at req_ (userFolder\AppData\Roaming\.nativescript-cli\extensions\node_modules\natives\index.js:143:24)
    at Object.req [as require] (userFolder\AppData\Roaming\.nativescript-cli\extensions\node_modules\natives\index.js:55:10)
    at Object.<anonymous> (userFolder\AppData\Roaming\.nativescript-cli\extensions\node_modules\fstream\node_modules\graceful-fs\fs.js:1:37)
    at Module._compile (internal/modules/cjs/loader.js:759:30)
    at Object.Module._extensions..js (internal/modules/cjs/loader.js:770:10)
    at Module.load (internal/modules/cjs/loader.js:628:32)
    at Function.Module._load (internal/modules/cjs/loader.js:555:12)
    at Module.require (internal/modules/cjs/loader.js:666:19)
    at require (internal/modules/cjs/helpers.js:16:16)
    at Object.<anonymous> (userFolder\AppData\Roaming\.nativescript-cli\extensions\node_modules\fstream\node_modules\graceful-fs\graceful-fs.js:3:27)
    at Module._compile (internal/modules/cjs/loader.js:759:30)
    at Object.Module._extensions..js (internal/modules/cjs/loader.js:770:10)
    at Module.load (internal/modules/cjs/loader.js:628:32)
    at Function.Module._load (internal/modules/cjs/loader.js:555:12)
    at Module.require (internal/modules/cjs/loader.js:666:19)
    at emitWarning (internal/process/promises.js:120:15)
    at processPromiseRejections (internal/process/promises.js:168:7)
    at processTicksAndRejections (internal/task_queues.js:90:32)
(node:6632) ReferenceError: primordials is not defined
    at fs.js:27:35
    at req_ (userFolder\AppData\Roaming\.nativescript-cli\extensions\node_modules\natives\index.js:143:24)
    at Object.req [as require] (userFolder\AppData\Roaming\.nativescript-cli\extensions\node_modules\natives\index.js:55:10)
    at Object.<anonymous> (userFolder\AppData\Roaming\.nativescript-cli\extensions\node_modules\fstream\node_modules\graceful-fs\fs.js:1:37)
    at Module._compile (internal/modules/cjs/loader.js:759:30)
    at Object.Module._extensions..js (internal/modules/cjs/loader.js:770:10)
    at Module.load (internal/modules/cjs/loader.js:628:32)
    at Function.Module._load (internal/modules/cjs/loader.js:555:12)
    at Module.require (internal/modules/cjs/loader.js:666:19)
    at require (internal/modules/cjs/helpers.js:16:16)
    at Object.<anonymous> (userFolder\AppData\Roaming\.nativescript-cli\extensions\node_modules\fstream\node_modules\graceful-fs\graceful-fs.js:3:27)
    at Module._compile (internal/modules/cjs/loader.js:759:30)
    at Object.Module._extensions..js (internal/modules/cjs/loader.js:770:10)

你的环境配置是：NodeJS 12.1.0，npm 6.4.1，NativeScript CLI 5.3.4。错误根源在于Node.js 12.x移除了primordials这个内部API，但NativeScript CLI 5.3.4依赖的旧版graceful-fs库还在调用它，导致启动时崩溃。

解决办法 #

方案一：降级Node.js到兼容版本（推荐）

NativeScript CLI 5.3.4官方适配的Node.js版本是8.x或10.x的LTS版本，这是最稳妥的解决方式：

• 卸载当前安装的Node.js 12.1.0
• 下载并安装Node.js 10.x系列的LTS版本（比如10.24.1）
• 重启NativeScript Sidekick，问题即可解决

方案二：手动替换兼容版本的graceful-fs

如果不想降级Node.js，可以手动修复CLI的依赖库：

• 打开文件路径：userFolder\AppData\Roaming\.nativescript-cli\extensions\node_modules\fstream\node_modules
• 删除该路径下的graceful-fs文件夹
• 在这个路径下打开命令提示符，执行命令：

  npm install graceful-fs@4.2.10
  

• 重新启动NativeScript Sidekick即可

补充说明 #

如果方案二执行后仍有异常，建议优先选择方案一，因为旧版NativeScript对Node.js新版本的兼容性支持有限，版本匹配能避免后续更多潜在问题。

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