Node.js 自 v12 起已废弃并移除 NODE_PATH 支持，CommonJS 模块解析不依赖它；推荐用 package.json 的 "exports" 配置路径映射，或借助 tsconfig-paths、自封装 require 辅助函数实现路径简化。
CommonJS 本身不支持 NODE_PATH 简化路径引入，这是个常见误解。Node.js 自 v12 起已废弃并移除了对 NODE_PATH 的支持（仅在某些旧版本中部分生效），且 CommonJS 模块解析机制默认只从 node_modules 和当前文件的相对/绝对路径查找模块，NODE_PATH 并不能像 Webpack 的 resolve.alias 那样“映射”路径。
为什么 NODE_PATH 在现代 Node.js 中基本失效
Node.js 官方明确表示：NODE_PATH 是遗留特性，不再推荐使用，且在 ESM 和大多数 CommonJS 场景下被忽略。即使设置（如 export NODE_PATH=./src），require('utils/helper') 仍会报错 —— 因为 Node 不会把 NODE_PATH 当作模块根目录去拼接，而是仅用于 fallback 查找（且需模块已通过 main 字段导出，实际极少生效）。
替代方案：用 package.json 的 "exports" + "imports"（推荐）
适用于 Node.js ≥ 12.20+，无需额外工具，原生支持：
- 在项目根目录的
package.json中配置：
{
"name": "my-app",
"type": "commonjs",
"exports": {
"./*": "./src/*",
"./utils/*": "./src/utils/*",
"./components/*": "./src/components/*"
}
}
然后任何地方都可直接写：
立即学习“Java免费学习笔记（深入）”；
const helper = require('my-app/utils/helper'); // ✅ 自动解析到 src/utils/helper.js
const layout = require('my-app/components/layout');
注意：my-app 必须是当前项目的 name，且必须本地安装（即本项目作为自己的依赖，可通过 npm link 或直接引用自身）。
轻量级方案：用 tsconfig-paths（即使不用 TypeScript）
借助 ts-node 或 node -r ts-node/register + tsconfig.json 的路径映射，CommonJS 也能享受别名：
- 安装：
npm install --save-dev ts-node typescript - 新建
tsconfig.json：
{
"compilerOptions": {
"baseUrl": ".",
"paths": {
"@utils/*": ["src/utils/*"],
"@models/*": ["src/models/*"],
"@config": ["src/config/index.js"]
}
}
}
运行时加注册器：node -r ts-node/register index.js，代码中即可：
const helper = require('@utils/helper');
最兼容方案：封装一个 require 辅助函数
不依赖外部工具，适合纯 CommonJS 小项目：
- 在项目根建
lib/require.js：
const path = require('path');
const { createRequire } = require('module');
const requireRoot = createRequire(path.resolve(__dirname, '../package.json'));
function req(relPath) {
return requireRoot(path.join(__dirname, '..', relPath));
}
module.exports = req;
使用：
const req = require('./lib/require');
const config = req('src/config/db');
const service = req('src/services/user');
