萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Node.js require 路徑解析機制全解析:相對、絕對、核心模塊與 node_modules

模塊分類

  • 核心模塊:編譯進二進制,如 http、fs、path,優先級最高,require('http') 直接返回。
  • 文件模塊:用戶編寫的 .js/.json/.node 文件,需路徑解析。

路徑解析規則

1. 相對路徑(以 ./ 或 ../ 開頭)

require('./module/server');      // 當前目錄下 module/server.js
require('./module/server.js');   // 顯式後綴
require('../utils/helper');      // 上級目錄

**相對於調用 require 的文件所在目錄**,而非工作目錄(process.cwd())。

2. 絕對路徑(以 / 或盤符開頭)

require('/home/user/project/module/server');
require('F:/project/module/server'); // Windows

直接定位,無查找過程,性能最佳但可移植性差。

3. 非相對非絕對路徑(模塊名):查找 node_modules

require('express'); // 非路徑字符串

查找順序:

  1. 當前文件目錄下 node_modules
  2. 父級目錄 node_modules,遞歸至根目錄
  3. 全局安裝目錄(npm root -g)
  4. NODE_PATH 環境變量指定目錄

文件擴展名自動補全優先級

  1. .js
  2. .json(解析為 JSON 對象)
  3. .node(C++ 插件,dlopen 加載)

目錄導入:若路徑指向目錄,按 package.json 的 main 字段,或 index.js/index.json/index.node 順序查找。

實戰示例

// 專案結構
// project/
//   index.js
//   module/
//     server.js
//   node_modules/
//     express/

// index.js
var server = require("./module/server"); // 相對路徑
server.start();

// module/server.js
var http = require("http"); // 核心模塊
function start() { ... }
exports.start = start; // CommonJS 導出

常見坑點與最佳實踐

  1. 避免同步 require 在熱路徑:啟動時加載,運行時用動態 import()。
  2. 循環依賴:CommonJS 返回已執行部分的 exports,可能拿到未完全初始化的對象。重構拆分共享依賴。
  3. 路徑別名:配置 webpack alias、tsconfig paths、babel-plugin-module-resolver 簡化 require('../../../utils')。
  4. ESM 互操作:require() 不能加載 ESM 模塊,需用動態 import()。
  5. __dirname vs process.cwd():前者為當前文件目錄,後者為命令執行目錄,相對路徑基準不同。

調試技巧

console.log(require.resolve('./module/server')); // 打印解析後的絕對路徑
console.log(module.paths); // 打印 node_modules 查找路徑列表
copyright © 萬盛學電腦網 all rights reserved