Package.json 的imports 和 exports

也就是说imports只对当前包内的文件生效,而exports 可以根据 其他人如何导入我的包内的文件生效

对,准确说是这样

imports 和 exports 的作用域不一样,而且语义也不一样。

imports

它是"当前包内部"的解析规则。

也就是在这个包里,代码写:

js 复制代码
import x from '#/foo'

时,Node/Vite 会在"当前 package"的上下文里查 package.json#imports,并把它映射成真正的文件路径。

它不关心"别人怎么从外部 import 你的包";它关心的是:

  • 这个包内部的源代码
  • 当前模块如何解析 # 开头的 specifier

所以它只对当前包内的模块生效。


exports

它是"对外发布接口"的规则。

比如你在包里配置:

json 复制代码
{
  "name": "my-lib",
  "exports": {
    ".": {
      "import": "./dist/index.mjs",
      "require": "./dist/index.cjs"
    },
    "./foo": {
      "import": "./dist/foo.mjs",
      "require": "./dist/foo.cjs"
    }
  }
}

这种配置决定的是:

  • 外部代码怎么从你的包里 import
  • 允许哪些入口暴露出来
  • 根据 import / require / node / browser 等条件返回不同文件

也就是说,exports 控制的是:

  • 别人如何导入我这个包
  • 这个包对外暴露哪些文件
  • 入口如何按环境区分 ESM / CJS

一句话区分

  • imports:当前包自己内部用
  • exports:别人外部使用这个包时用

举个例子

你的包内

json 复制代码
{
  "imports": {
    "#/*": "./src/*"
  }
}

在这个包内部写:

ts 复制代码
import a from '#/utils/a'

能用。

但外部项目:

js 复制代码
import myLib from 'your-package'

不会去读这个 imports。


你的包对外

json 复制代码
{
  "exports": {
    ".": {
      "import": "./dist/index.mjs",
      "require": "./dist/index.cjs"
    }
  }
}

外部项目再用:

js 复制代码
import myLib from 'your-package'

或者

js 复制代码
const myLib = require('your-package')

就会按条件走不同入口。


所以你的理解是对的

imports 只对当前包内的文件生效;

exports 影响的是其他人如何导入这个包里的内容。

这两个字段是不同层面的规则,别混在一起。

如果你愿意,我可以再补一个"imports / exports / resolve.alias / tsconfig.paths"的四者对照图,最容易记住。

相关推荐
黑土豆2 天前
网页框一下就能截图Region-snap:我把这套功能封装成了 npm 包,支持 Vue 和 React
前端·javascript·npm
dreams_dream6 天前
微信小程序-使用npm包
微信小程序·小程序·npm
周杰伦的稻香7 天前
Hexo 腾讯视频追剧页插件:hexo-tengxun-eucalyptus 安装使用
npm
怒放的生命199115 天前
本地用 pnpm 省磁盘,团队继续用 npm:极简实践
前端·npm·node.js
江屿风18 天前
【Plain Language Large Model】【从浏览器到全栈:一课精通Node.js三剑客】流食般投喂
笔记·前端框架·npm·node.js·js·npx
少年的范儿20 天前
Windows 安装 Node.js 教程:nvm 版本管理 + pnpm 安装配置
windows·npm·node.js
peach20 天前
同样是装依赖,为什么 npm 长成 node_modules,Maven 长成 .m2
npm·node.js·maven
chunyublog22 天前
HDFS 上传文件名空格问题排障教程
前端·javascript·npm
MasonYyp23 天前
安装npm依赖仓库Verdaccio
前端·npm·node.js
jiangliushi624 天前
GPT-6.1 Sol 免费用:PowerShell 装 Codex 报“禁止运行脚本 npm.ps1”?一条命令解决
前端·gpt·npm