npm packages与node_modules是否等价？二者有什么区别？

二者完全不是等价概念，不存在一个npm package就对应一个node_module的关系，二者在npm生态里的定位有本质区别。

概念定义 #

npm package #

npm package是符合npm包规范的可复用代码分发单元，核心判定标准是根目录存在符合规范的package.json元信息文件，包含明确的包名、版本号等字段：

• 它可以是你本地开发的、从未发布到任何仓库的项目代码
• 可以是发布到npm公共/私有镜像源的可安装压缩包
• 也可以是本地压缩包、Git仓库地址指向的代码集合

举个最直白的例子：你本地新建个文件夹，写个index.js，再加个合法的package.json，哪怕你从来没上传过，它本身就是一个标准的npm package。

node_modules #

node_modules是npm、yarn、pnpm等包管理器在执行依赖安装时，自动生成的依赖存放目录，一般出现在项目根目录或者全局Node.js安装路径下：

• 这个目录完全由包管理器自动维护，正常开发流程里不需要手动修改内部内容
• 它的内部结构随包管理器的安装策略变化：npm 3.x之前是严格嵌套的依赖树结构，npm 3.x之后改成扁平化结构减少重复依赖安装，pnpm则是通过软链接把全局存储的包映射到这个目录下
• 目录里的内容不全是合法的npm包：可能存在包管理器生成的辅助文件、没有package.json的零散依赖片段等内容。

二者的关联与常见误区 #

• 你通过npm install命令安装的第三方npm package，默认会被解压存放到项目的node_modules目录下，但反过来node_modules里的所有内容不都是npm包：你手动在里面新建个空文件夹，它在node_modules路径下，但绝对不是npm包
• 一个npm package自身的目录里也可能存在node_modules子目录，用来存放这个包自己的运行依赖，是实现依赖版本隔离的常见方式
• npm package不是必须放到node_modules里才能使用：你可以通过相对路径直接引用本地的npm包，也可以通过npm link把本地包链接到全局使用，完全不需要走安装到项目node_modules的流程
• 日常交流里很多人会把node_modules里安装好的单个包口语化简称为node_module，这只是场景化的简称，不是严谨的概念定义，不能作为二者等价的依据。

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