调试嵌套目录下npx的环境选择问题

1. 查看npx实际调用的包路径 #

执行 npx --which <目标包名>，比如 npx --which vite，命令会返回npx最终找到的包的绝对路径，通过路径就能直观判断是使用了当前目录（c/）的node_modules，还是上层目录（a/）的。

2. 输出npx的完整检索日志 #

启用npx的调试模式，在命令前添加NODE_DEBUG=npx前缀，示例：

NODE_DEBUG=npx npx <你的命令>

日志会详细展示npx查找node_modules目录的顺序、每个目录的检查结果、是否命中包等信息，能精准定位它为何会检索到上层目录。

3. 确认当前目录的npm环境 #

通过以下命令验证本地环境：

• npm root：输出当前工作目录对应的本地node_modules路径
• npm root -g：输出全局node_modules路径
  结合这两个结果，再对照npx的日志，就能理清环境优先级问题。

4. 强制npx使用当前目录的包 #

如果要避免npx检索上层目录，可通过参数强制限定范围：

npx --no-install --prefix ./ <目标包名>

或者直接调用本地包的二进制文件：

./node_modules/.bin/<命令名>

这样能完全隔离上层目录的环境影响。

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