Node.js中如何正确导入官方内置WASI模块

核心原因是npm仓库存在同名第三方老旧wasi包，和Node.js内置的WASI模块重名，不加特殊标识的导入语句会优先查找node_modules下的第三方包，而非内置模块，按以下步骤操作即可解决：

• 先清理冲突依赖：在项目根目录执行npm uninstall wasi，删除package.json和node_modules里安装的第三方wasi包，从根源排除同名包干扰。
• 检查Node.js版本：官方内置WASI模块要求Node.js版本不低于12.16.0，所有当前维护的LTS版本均已默认内置，执行node -v可查看当前运行版本，版本过低请先升级Node.js。
• 用标准写法导入内置模块：导入内置模块时必须加node:协议前缀，明确告知Node.js要加载核心内置模块，不要查找第三方包，两种模块系统对应写法如下：
  • ES Module模式（package.json中声明"type": "module"）：

    import { WASI } from 'node:wasi';
    

  • CommonJS模式：

    const { WASI } = require('node:wasi');
    

• 修复WebStorm类型误报：
  先执行npm install --save-dev @types/node安装最新版Node.js官方类型定义，之后打开WebStorm设置，找到Node.js代码辅助配置页，确认已启用Node.js核心库类型关联，不要将第三方wasi包设为类型来源，重启IDE后代码检测就会正确匹配官方WASI的API规范，不会再出现识别错误。

校验方式：导入WASI后打印其原型对象，如果能看到官方文档标注的initialize、start等实例方法，就说明已经正确加载了Node.js内置的官方WASI实现。

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