Node.js 模块导出问题：正确导出多个函数避免 undefined 错误-js教程-PHP中文网

Node.js 模块导出问题：正确导出多个函数避免 undefined 错误

本文详解 Node.js 中 module.exports 与 exports 的本质区别，指出因 Unicode 字符混淆导致的拼写错误，并提供统一、安全的多函数导出方案，确保所有导出函数在导入时均可正常访问。

本文详解 node.js 中 `module.exports` 与 `exports` 的本质区别，指出因 unicode 字符混淆导致的拼写错误，并提供统一、安全的多函数导出方案，确保所有导出函数在导入时均可正常访问。

在 Node.js 模块系统中，exports 和 module.exports 常被误认为等价，实则存在关键差异：exports 仅是 module.exports 的初始引用别名；一旦对 module.exports 赋值（如 module.exports = {...}），该引用即被覆盖，而 exports 不再同步更新。更隐蔽的风险来自拼写错误——原代码中：

exports.destrοyImage = destroyImage; // ❌ 注意：'ο' 是希腊字母 omicron（U+03BF），非英文字母 'o'（U+006F）

此处 destrοyImage 表面看似 destroyImage，但实际使用了 Unicode 希腊小写字母 ο（U+03BF），导致键名不匹配。当在导入端解构时：

const { uploadImage, destroyImage } = require('../models/cloudinaryUploader');

destroyImage 对应的键在 exports 对象中并不存在（真实键名为 destrοyImage），因此解构结果为 undefined。

✅ 正确做法是统一采用 module.exports 对象字面量导出，既避免引用丢失风险，又杜绝 Unicode 混淆：

Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载

// cloudinaryUploader.js
const cloudinary = require('cloudinary').v2;
const config = require('config');
const winston = require('winston');

cloudinary.config({
  secure: true,
  cloud_name: 'loofy',
  api_key: config.get('cloudinary_api_key'),
  api_secret: config.get('cloudinary_secret')
});

const uploadImage = async (localImage, optionsIn) => {
  const options = {
    use_filename: true,
    unique_filename: false,
    overwrite: true
  };

  if (optionsIn) {
    Object.keys(optionsIn).forEach(key => {
      options[key] = optionsIn[key];
    });
  }

  try {
    const result = await cloudinary.uploader.upload(localImage, options);
    return result;
  } catch (error) {
    winston.warn(error.message);
    return null;
  }
};

const destroyImage = async (public_id) => {
  try {
    const result = await cloudinary.uploader.destroy(public_id);
    return result;
  } catch (error) {
    winston.error(`Cloudinary destroy failed: ${error.message}`);
    throw error; // 显式抛出便于上层处理
  }
};

// ✅ 推荐：直接赋值 module.exports，语义清晰、无歧义、防拼写陷阱
module.exports = {
  uploadImage,
  destroyImage
};

导入端保持不变，解构将准确命中：

const { uploadImage, destroyImage } = require('../models/cloudinaryUploader');
// ✅ 现在 destroyImage 已正确定义

⚠️ 注意事项：

禁用 exports.xxx = yyy 混合导出：若模块中已使用 module.exports = {...}，后续 exports.xxx 赋值将无效；
启用 ESLint 规则：添加 no-restricted-syntax 或自定义规则，禁止 exports.xxx 写法，强制统一风格；

开发环境校验：可在模块末尾添加断言，确保导出完整性：

// 开发阶段可选：防止遗漏导出
if (typeof module.exports.uploadImage !== 'function' || typeof module.exports.destroyImage !== 'function') {
  throw new Error('Cloudinary module exports missing required functions');
}