npm包cdk与aws-cdk的差异及npx执行异常原因咨询

一、两个包的本质区别 #

• aws-cdk：AWS官方推出的CDK Toolkit核心包，所有CDK CLI功能的实际提供者。早期AWS CDK的命令行工具仅通过该包发布。
• cdk：社区维护的别名包，自身不提供任何功能，仅依赖并转发调用aws-cdk的CLI命令，目的是让用户能用更短的cdk命令替代aws-cdk。

二、你的npx行为异常原因拆解 #

你观察到的现象核心在于两个包生成的可执行命令不同，结合npx的查找逻辑导致：

1. 为什么npx -- cdk仍执行2.32.0版本？
   你之前全局安装过cdk@2.32.0，这个包会在系统PATH中生成cdk可执行命令。即使后来安装aws-cdk，之前的cdk命令并未被覆盖或删除，npx查找时会优先找到这个已存在的全局命令，因此直接执行2.32.0版本。

2. 为什么npx -- aws-cdk仍要求安装？
   aws-cdk包全局安装后，会生成aws-cdk可执行命令，但可能出现两种情况导致npx找不到它：

   • 安装过程中PATH未自动更新，你的shell没识别到新添加的aws-cdk命令；
   • 全局npm包的安装目录不在当前shell的PATH范围内，npx无法定位到已安装的aws-cdk。

验证与修复步骤 #

• 先确认全局可执行命令的位置：

  which cdk
  which aws-cdk
  

  执行后会看到cdk指向之前安装的cdk包路径，而aws-cdk可能无输出（说明PATH没配置对）。

• 修复aws-cdk的npx调用问题：

  1. 强制重新安装全局aws-cdk包，确保安装路径正确：

     npm install -g aws-cdk@2.32.0 --force
     

  2. 刷新shell的PATH缓存（bash执行source ~/.bashrc，zsh执行source ~/.zshrc）；
  3. 再次执行npx -- aws-cdk --version，此时应能调用到全局安装的2.32.0版本。

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