package.json中“type“: “module“是什么含义,es6和commonjs的区别以及require和import使用场景

"type": "module" 是 Node.js 中 package.json 文件的一个字段,用于指示该项目的模块系统类型。它决定了项目中的 .js 文件应被视为 ECMAScript 模块 (ESM) 还是 CommonJS 模块 (CJS)。

含义和作用:

  • "type": "module" :项目中的 .js 文件将默认被视为 ECMAScript 模块 (ESM/ES6)。
  • 默认行为(未定义 "type" :项目中的 .js 文件将默认被视为 CommonJS 模块 (CJS)。

区别:

  • CommonJS ("type" 未定义或等于 "type": "commonjs")

    • 使用 require()module.exports
    • 文件扩展名 .cjs 通常用于明确表示 CommonJS 文件。
  • ECMAScript 模块 ("type": "module")

    • 使用 importexport 语法。
    • 文件扩展名 .mjs 通常用于明确表示 ECMAScript 模块文件。
    • 不支持 require(),只能使用 import 语法。

什么时候使用 "type": "module"

如果你正在编写现代 JavaScript 应用程序,并希望使用原生的 ESM 语法 (importexport),可以在 package.json 中添加 "type": "module"。这使得你的 .js 文件默认被解析为 ECMAScript 模块。

示例:

package.json:

javascript 复制代码
{
  "name": "my-project",
  "version": "1.0.0",
  "type": "module"
}

文件中:

你可以使用 import:

javascript 复制代码
import path from 'path';
import fs from 'fs';

注意 : 如果你的项目中有需要同时使用 ESM 和 CJS 的文件,可以使用 .mjs(ESM)和 .cjs(CJS)扩展名来明确区分模块类型,而不用依赖 package.json 中的 "type" 字段。

所以我写了一个js脚本,使用require的时候报错了:

node ./cli/creatIcon.js

file:///Users/song/Project/my/PakePlus/cli/creatIcon.js:1

const path = require('path')

^

ReferenceError: require is not defined in ES module scope, you can use import instead

This file is being treated as an ES module because it has a '.js' file extension and '/Users/song/Project/my/PakePlus/package.json' contains "type": "module". To treat it as a CommonJS script, rename it to use the '.cjs' file extension.

这是因为你在项目的 package.json 中使用了 "type": "module",使得 Node.js 默认将 .js 文件视为 ES 模块(ESM)。在 ESM 模块中不能使用 require(),需要使用 import。你有两种解决方案:

解决方案 1:将文件扩展名改为 .cjs

creatIcon.js 文件重命名为 creatIcon.cjs,这样 Node.js 会将其视为 CommonJS 模块,你可以继续使用 require()

解决方案 2:修改代码以使用 import

require() 替换为 import 语法,示例如下:

这两种方法都可以解决 require is not defined 的错误。

  1. 修改 creatIcon.js

    javascript 复制代码
    import path from 'path';
    import fs from 'fs';
    import png2icons from 'png2icons';
    import sharp from 'sharp';
    
    // 你的其他代码逻辑
  2. 确保 package.json 中有 "type": "module": 如果已经存在,则无需更改。

注意事项

  1. import 语法只能在支持 ESM 的环境中使用(Node.js 版本必须是 12+)。
  2. 如果使用 import 语法,文件加载等异步操作需要 await,并且在模块作用域中需要使用 async 函数或 top-level await
相关推荐
AliPaPa几秒前
你可能忽略了useSyncExternalStore + useOptimistic + useTransition
前端·react.js
parade岁月11 分钟前
nuxt和vite使用环境比变量对比
前端·vite·nuxt.js
小帆聊前端13 分钟前
Lodash 深度解读:前端数据处理的效率利器,从用法到原理全拆解
前端·javascript
Harriet嘉32 分钟前
解决Chrome 140以上版本“此扩展程序不再受支持,因此已停用”问题 axure插件安装问题
前端·chrome
FuckPatience37 分钟前
前端Vue 后端ASP.NET Core WebApi 本地调试交互过程
前端·vue.js·asp.net
Kingsdesigner41 分钟前
从平面到“货架”:Illustrator与Substance Stager的包装设计可视化工作流
前端·平面·illustrator·设计师·substance 3d·平面设计·产品渲染
一枚前端小能手1 小时前
🔍 那些不为人知但是好用的JS小秘密
前端·javascript
屿小夏1 小时前
JSAR 开发环境配置与项目初始化全流程指南
前端
微辣而已1 小时前
next.js中实现缓存
前端
Dcc1 小时前
纯 css 实现前端主题切换+自定义方案
前端·css