如何引用同一npm包在node_modules中的已安装版本？

核心问题解析 #

你遇到的问题是Node.js模块解析优先级导致的：在本地包中导入packageName时，Node会优先读取当前包的package.json配置（也就是你设置的exports字段），因此会指向本地的./source/index.js，而非node_modules里的依赖版本。

下面是几种可行的最优实现方式：

1. 用构建工具的路径别名（推荐，适合带构建流程的项目） #

如果你的项目使用Webpack、Rollup、Vite这类构建工具，可通过配置路径别名直接重定向packageName的导入路径到node_modules中的版本：

• Webpack 示例：
  在webpack.config.js中添加：

  const path = require('path');
  
  module.exports = {
    // ...其他配置
    resolve: {
      alias: {
        'packageName': path.resolve(__dirname, 'node_modules/packageName/source/index.js')
      }
    }
  };
  

• Vite 示例：
  在vite.config.js中添加：

  import { defineConfig } from 'vite';
  import path from 'path';
  
  export default defineConfig({
    resolve: {
      alias: {
        'packageName': path.resolve(__dirname, 'node_modules/packageName/source/index.js')
      }
    }
  });
  

这种方式无需修改业务代码，完全在构建层面解决问题，兼容性好，适合大多数前端/Node项目。

2. 利用Node.js的imports字段（适合纯Node.js项目） #

你之前用imports字段报错，是因为Node.js的imports不允许直接用相对路径指向node_modules，必须使用外部依赖的包名格式。正确配置方式如下：

1. 在本地包的package.json中添加：

   "imports": {
     "#packageName": "packageName/source/index.js"
   }
   

   这里的#前缀是Node.js内部导入的标识，用于区分外部依赖。

2. 在代码中修改导入语句，使用自定义的内部别名：

   import { x } from '#packageName';
   

   此时Node会解析到node_modules/packageName/source/index.js，而非本地文件。

这种方式符合Node.js模块规范，无需额外工具，但需要修改代码中的导入路径。

3. 开发环境临时修改exports字段（适合不想改代码的纯Node场景） #

如果你不想修改代码或依赖构建工具，可以写一个简单脚本，在开发时临时替换package.json的exports字段，指向node_modules中的版本：

1. 创建dev-start.js脚本：

   const fs = require('fs');
   const path = require('path');
   const packagePath = path.resolve(__dirname, 'package.json');
   
   // 备份原始package.json
   const originalPackage = fs.readFileSync(packagePath, 'utf8');
   const parsed = JSON.parse(originalPackage);
   
   // 修改exports指向node_modules版本
   parsed.exports = './node_modules/packageName/source/index.js';
   fs.writeFileSync(packagePath, JSON.stringify(parsed, null, 2));
   
   // 启动开发服务/脚本
   const child = require('child_process').spawn('node', ['./your-entry-file.js'], { stdio: 'inherit' });
   
   // 退出时恢复原始package.json
   process.on('exit', () => {
     fs.writeFileSync(packagePath, originalPackage);
   });
   child.on('exit', () => {
     process.exit();
   });
   

2. 在package.json的scripts中添加：

   "scripts": {
     "dev": "node dev-start.js"
   }
   

这种方式无需改代码，但要注意不要把修改后的package.json提交到版本库，脚本会在退出时自动恢复。

方案对比与推荐 #

• 用构建工具的项目：优先选路径别名，无代码侵入，兼容性最好。
• 纯Node.js项目：优先选**imports字段方案**，符合规范，长期维护更清晰。
• 临时快速解决：可以用修改exports的脚本方案，但不推荐长期使用。

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