问题场景 #

以dependency-cruiser包为例：

• 本地安装：执行 npm install --save-dev dependency-cruiser，输出仅提示添加了依赖包，但无法直接使用depcruise命令；
• 全局安装：执行 npm install --global dependency-cruiser，输出显示创建了多个命令软链接，此时能正常使用depcruise命令。

差异产生的核心原因 #

这本质是npm全局安装与本地安装的可执行命令暴露机制不同：

• 全局安装时，npm会将包的可执行文件（比如depcruise对应的dependency-cruise.js）创建软链接到系统PATH环境变量包含的目录（比如你输出里的C:\Users\me\AppData\Roaming\npm）。因为这个目录在系统PATH里，终端能直接定位到depcruise命令，所以可以直接输入执行。
• 本地安装时，包的可执行文件会被放在项目根目录的node_modules/.bin文件夹下，但这个目录默认不在系统PATH里，终端找不到该命令，自然无法直接调用。

从安装输出也能直观看到区别：全局安装时npm明确打印了软链接的路径，而本地安装仅提示依赖添加完成，没有做任何PATH相关的链接操作。

本地安装后调用depcruise命令的实用方法 #

方法1：用npx直接调用（最推荐）

npx是npm自带的工具，它会自动查找项目本地node_modules/.bin目录下的可执行命令，无需额外配置，直接在终端输入：

npx depcruise [你的分析路径/参数]

比如要分析src目录的依赖关系，就执行 npx depcruise src，简单高效。

方法2：在package.json的scripts中配置自定义命令

在项目的package.json里添加脚本：

{
  "scripts": {
    "depcruise": "depcruise src", // 可以直接写你常用的参数
    "depcruise:format": "depcruise-fmt"
  }
}

之后在终端执行：

npm run depcruise
# 或者执行格式化命令
npm run depcruise:format

npm在执行scripts中的命令时，会自动把项目的node_modules/.bin目录临时加入当前会话的PATH，所以能直接找到depcruise命令。这种方法适合把常用的依赖分析命令固化下来，团队成员也能统一使用。

方法3：手动临时添加PATH（不推荐）

如果一定要在终端直接输入depcruise，可以临时把项目的node_modules/.bin加到当前终端的PATH中（不同系统命令不同）：

• Windows（cmd）：

set PATH=%PATH%;.\node_modules\.bin

• Linux/macOS：

export PATH=$PATH:./node_modules/.bin

但这种方法仅在当前终端会话有效，切换项目或重启终端后就失效，而且多项目切换时容易出现包版本冲突，所以不推荐作为常规用法。

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