问题：如何使用 npm 查看已安装的所有包？

Question

**问题：如何使用 npm 查看已安装的所有包？** 在日常开发中，了解当前项目或全局环境中已安装了哪些 npm 包对于依赖管理非常重要。那么，如何使用 npm 查看本地项目和全局环境中已安装的所有包？`npm` 提供了哪些命令来分别查看本地和全局安装的包？这些命令的输出结果是否可以按名称、版本或其他条件进行排序或过滤？此外，如何判断某个包是开发依赖还是生产依赖？理解这些操作不仅能帮助开发者更好地维护项目依赖，还能有效排查版本冲突等问题。掌握 `npm list` 和 `npm ls` 等相关命令的使用方式，是每位前端工程师应具备的基础技能。

Answer 1

一、npm 查看已安装包的基本命令

在使用 npm 进行项目开发时，了解当前环境中安装了哪些依赖包是基础且必要的操作。npm 提供了多个命令来查看本地项目和全局环境中安装的包。

• npm list 或 npm ls：查看当前项目中安装的所有依赖包。
• npm list -g 或 npm ls -g：查看全局安装的包。

这两个命令会输出一个树状结构，展示依赖关系和版本号。

二、区分本地与全局安装的包

类型	命令	说明
本地安装	npm list	显示当前项目的 node_modules 中安装的包及其依赖。
全局安装	npm list -g	显示系统级安装的包，通常用于 CLI 工具。

三、深入理解输出结果：依赖层级与类型

运行 npm list 命令后，你会看到类似如下输出：

project-name@1.0.0 /path/to/project
├── express@4.17.1
├── mongoose@5.13.0
└─┬ react@17.0.2
  └── scheduler@0.20.2

其中：

• ├── 表示直接依赖（一级依赖）
• └─┬ 表示嵌套依赖（二级或更深依赖）

此外，可以通过添加参数查看更详细的信息：

• npm list --depth=0：仅显示顶层依赖。
• npm list --json：以 JSON 格式输出依赖信息，便于程序解析。

四、判断开发依赖与生产依赖

npm 支持将依赖分为两类：

1. 生产依赖（dependencies）：项目运行所必需的包。
2. 开发依赖（devDependencies）：仅在开发阶段使用的工具，如测试框架、构建工具等。

可通过以下命令分别查看：

• npm list --prod：只列出生产环境依赖。
• npm list --dev：只列出开发环境依赖。

五、排序与过滤依赖列表

虽然 npm 原生命令不直接支持按名称或版本排序，但可以结合 shell 命令进行处理。例如：

npm list --depth=0 | sort

如果需要根据关键字过滤：

npm list | grep "lodash"

或者使用第三方工具如 jq 处理 JSON 输出：

npm list --json | jq '.dependencies | keys'

六、可视化依赖结构与冲突排查

当项目中存在多个版本的同一依赖时，可能导致冲突。此时可使用以下命令查找重复依赖：

npm list <package-name>

该命令会列出所有不同路径下安装的该包版本，有助于识别潜在的冲突点。

graph TD A[执行 npm list] --> B{是否包含指定包?} B -->|是| C[显示所有版本及路径] B -->|否| D[继续浏览其他依赖] C --> E[分析版本差异] D --> F[结束流程]