能否为Node.js项目所有子目录配置require全局自定义入口文件？

我太懂这种重复配置的烦躁了——为了让IDE里的入口文件置顶改了文件名，结果要给每个子目录加一模一样的package.json，完全是冗余工作。下面几个方案能帮你彻底摆脱这种情况：

方案1：自定义Node.js模块加载器（推荐，Node.js 18+稳定可用） #

Node.js的模块解析逻辑是可定制的，我们可以写一个自定义加载器，让它在加载目录时优先查找_index.js，不用依赖子目录的package.json。

步骤： #

1. 在项目根目录新建custom-loader.js，代码如下：

const { readFile } = require('fs/promises');
const { resolve } = require('path');

async function resolve(specifier, context, defaultResolve) {
  const { parentURL } = context;
  // 只处理相对路径的目录引入（比如./featureA、../utils）
  if (specifier.startsWith('./') || specifier.startsWith('../')) {
    const dirPath = new URL(specifier, parentURL).pathname;
    const targetIndex = resolve(dirPath, '_index.js');
    try {
      // 检查目标文件是否存在
      await readFile(targetIndex);
      // 如果存在，直接解析到这个文件
      return defaultResolve(new URL(`file://${targetIndex}`), context, defaultResolve);
    } catch (err) {
      // 不存在的话，回到默认解析逻辑（找package.json或index.js）
      return defaultResolve(specifier, context, defaultResolve);
    }
  }
  // 第三方模块或绝对路径，直接用默认解析
  return defaultResolve(specifier, context, defaultResolve);
}

module.exports = { resolve };

2. 启动项目时指定这个加载器：

node --loader ./custom-loader.js app.js

现在你直接require('./featureA')，Node.js会自动加载featureA/_index.js，完全不需要子目录的package.json。

小提示：如果用Node.js 12-17版本，需要把--loader换成--experimental-loader，因为这个特性在旧版本是实验性的。

方案2：封装自定义require工具函数 #

如果不想碰加载器特性，更简单的方式是写一个工具函数，统一处理你的模块引入：

1. 在项目根目录创建utils/loadFeature.js：

const path = require('path');

module.exports = function loadFeature(featurePath) {
  // 拼接目标目录的_index.js路径
  const fullPath = path.resolve(process.cwd(), featurePath, '_index.js');
  try {
    return require(fullPath);
  } catch (err) {
    // 找不到的话， fallback 到原生require逻辑
    return require(featurePath);
  }
};

2. 在app.js里用这个函数代替原生require：

const loadFeature = require('./utils/loadFeature');
const featureA = loadFeature('./featureA');
const featureB = loadFeature('./featureB');

这个方案零配置，只需要统一用自定义函数加载你的业务模块，非常轻量。

方案3：用npm脚本简化启动流程（配合方案1） #

如果用方案1的加载器，每次手动输入长命令太麻烦，可以在根目录的package.json里加个启动脚本：

{
  "scripts": {
    "start": "node --loader ./custom-loader.js app.js"
  }
}

之后只需要运行npm start，就能自动加载自定义加载器启动项目了。

这几个方案都能完美替代子目录里重复的package.json，你可以根据自己的Node.js版本和项目需求选择最适合的。

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