Njoy 骏九驿站

npx 是 Node.js 生态系统中一个用于执行 npm 包中可执行文件的命令行工具，自 npm 5.2.0 版本起内置，无需单独安装 。

核心作用

• 无需全局安装：可直接运行 npm 包中的命令，避免污染全局环境。
• 自动下载与执行：若本地或全局未安装指定包，npx 会临时从 npm 注册表下载并执行，执行后默认清理缓存（但保留以供复用）。
• 优先使用本地依赖：若项目中已安装该包（位于 node_modules/.bin），npx 会优先调用本地版本，避免版本冲突 。
• 支持指定版本：可通过 @version 指定运行特定版本，例如 npx create-react-app@5.0.0 my-app 。

典型使用场景

• 创建项目脚手架

  npx create-react-app my-app
  npx create-next-app@latest

• 运行一次性工具

  npx cowsay "Hello"        无需安装 cowsay
  npx http-server           启动本地 HTTP 服务器

• 调用本地开发依赖

  npx eslint src/           使用项目本地安装的 ESLint
  npx webpack               使用项目本地安装的 Webpack

• 测试不同 Node.js 版本

  npx node@14 --version     使用 Node.js 14 运行命令

工作原理简述

1. 查找顺序：

   • 当前目录下的可执行文件
   • node_modules/.bin/ 中的命令
   • 全局安装的包
   • 若均未找到，则从 npm 下载并缓存执行

2. 缓存机制：

   • 下载的包存储在缓存目录（如 ~/.npm/_npx 或 %APPDATA%\npm-cache\_npx），不会立即删除，以便下次快速使用 。
   • 缓存由 npm 定期清理（通常几周后），并非“用完即删” 。

3. 安全注意：

   • npx 只能执行具有 bin 字段的包（即包含可执行文件的 CLI 工具）。
   • 不建议运行来源不明的代码（如 npx gist:...），存在安全风险 。

常用选项

与 npm 的区别

💡 比喻：npm 像“买菜回家做饭”，npx 像“点外卖”——按需使用，无需长期占用资源 。

最佳实践建议

• 替代全局安装：将 npm install -g <tool> 替换为 npx <tool> 。
• 多项目协作：确保团队成员通过 npx 使用项目本地依赖，避免环境差异 。
• CI/CD 环境：利用 npx 保证构建工具版本一致，无需预装全局依赖 。

如需验证是否可用，运行：

npx --version

只要 Node.js 版本 ≥ 8.2.0（对应 npm ≥ 5.2.0），即可直接使用 。