npx @wordpress/create-block报exit code 1依赖冲突如何解决

问题根源 #

该报错是npm v7及以上版本默认启用严格对等依赖检查导致的，再加上你使用的Node v15.5.1属于非长期支持（LTS）版本，和@wordpress/scripts工具链的版本适配存在冲突，属于Gutenberg脚手架工具的已知历史兼容性问题。

具体解决步骤 #

步骤1：切换Node版本 #

优先使用Node.js 16.x或18.x的LTS版本，这两个版本是WordPress官方工具链的适配版本，可通过Node版本管理工具（如nvm、nvm-windows）快速切换版本。

步骤2：执行带依赖兼容参数的创建命令 #

清理之前生成的失败的my-first-block文件夹后，执行以下命令即可正常创建项目：

npx @wordpress/create-block my-first-block -- --legacy-peer-deps

命令中的--作用是将后面的--legacy-peer-deps参数透传给内部执行的npm install步骤，绕过严格的对等依赖检查，不会影响后续功能使用。

备选方案：手动初始化项目 #

如果上述命令仍执行失败，可以手动分步初始化：

1. 创建并进入项目目录：

mkdir my-first-block
cd my-first-block

2. 初始化npm项目：

npm init -y

3. 安装核心依赖：

npm install @wordpress/scripts --save-dev --legacy-peer-deps

4. 执行脚手架初始化：

npx @wordpress/create-block --no-install

验证安装 #

安装完成后执行npm run build，如果正常生成build目录下的打包文件，说明环境配置正常，后续开发执行npm run start即可启用热更新调试。

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