DEV Community ·

.js、.cjs 和 .mjs 文件扩展名的区别

💡 原文约300字/词，阅读约需1分钟。

📝

内容提要

JavaScript 的模块系统使用三种文件扩展名：.js（默认格式，支持 CJS 或 ESM），.cjs（明确为 CommonJS 模块，确保向后兼容），.mjs（用于 ESM 模块，强制使用现代语法）。新项目建议使用 .mjs，旧项目使用 .cjs 和 .mjs。使用 .js 时需在 package.json 中正确设置类型。

🎯

关键要点

.js 是默认文件格式，支持 CJS 或 ESM，使用时需根据项目类型确定。
.cjs 明确指定为 CommonJS 模块，确保向后兼容。
.mjs 用于 ESM 模块，强制使用现代语法。
新项目建议使用 .mjs，旧项目使用 .cjs 和 .mjs。
使用 .js 时需在 package.json 中正确设置类型，以避免混淆。

🔎

延伸解读

文件扩展名的选择

.js、.cjs 和 .mjs 各有其特定用途，选择合适的扩展名可以避免项目中的混淆。对于新项目，建议优先使用 .mjs，以便充分利用现代 JavaScript 的特性。而对于旧项目，使用 .cjs 可以确保与现有代码的兼容性。

避免配置错误

使用 .js 文件时，务必在 package.json 中正确设置类型，以避免 Node.js 在解析模块时产生混淆。错误的配置可能导致运行时错误，影响项目的稳定性和可维护性。

向后兼容性的重要性

.cjs 文件扩展名的使用确保了与旧版 Node.js 的兼容性，这对于维护老旧项目至关重要。开发者在处理遗留代码时，应优先考虑使用 .cjs，以避免潜在的兼容性问题。

❓

延伸问答

.js 文件的主要特点是什么？

.js 是默认文件格式，支持 CommonJS (CJS) 或 ES Modules (ESM)，使用时需根据项目类型确定。

.cjs 文件有什么特别之处？

.cjs 明确指定为 CommonJS 模块，确保向后兼容，适用于旧版本的 Node.js。

.mjs 文件的使用场景是什么？

.mjs 用于 ES Modules (ESM) 模块，强制使用现代语法，如 import 和 export。

在新项目中应该使用哪个文件扩展名？

新项目建议使用 .mjs，以便专注于 ESM 模块。

如何避免使用 .js 文件时的混淆？

使用 .js 时需在 package.json 中正确设置类型，以避免混淆。

旧项目应该如何选择文件扩展名？

旧项目应使用 .cjs 和 .mjs 作为不同的文件扩展名来管理模块。

🏷️