创建SvelteKit项目时遭遇依赖安装失败（Failed to install dependencies）错误

问题情况 #

此前多次执行npx sv create并选择全部默认选项均成功，但在Macbook Air M3设备上执行该命令时，出现依赖安装失败的错误。已尝试重启设备、更换干净目录操作，问题仍未解决。

完整错误信息 #

Failed to install dependencies
npm error code ERESOLVE
npm error ERESOLVE unable to resolve dependency tree
npm error
npm error While resolving: calc2@0.0.1
npm error Found: @sveltejs/vite-plugin-svelte@undefined
npm error node_modules/@sveltejs/vite-plugin-svelte
npm error   dev @sveltejs/vite-plugin-svelte@"^6.2.0" from the root project
npm error
npm error Could not resolve dependency:
npm error peer @sveltejs/vite-plugin-svelte@"^3.0.0 || ^4.0.0-next.1 || ^5.0.0 || ^6.0.0-next.0" from @sveltejs/kit@2.46.5
npm error node_modules/@sveltejs/kit
npm error   dev @sveltejs/kit@"^2.43.2" from the root project
npm error   peer @sveltejs/kit@"^2.0.0" from @sveltejs/adapter-auto@6.1.1
npm error   node_modules/@sveltejs/adapter-auto
npm error     dev @sveltejs/adapter-auto@"^6.1.0" from the root project
npm error
npm error Fix the upstream dependency conflict, or retry
npm error this command with --force or --legacy-peer-deps
npm error to accept an incorrect (and potentially broken) dependency resolution.
npm error
npm error
npm error For a full report see:npm error /Users/lawrencebaldwin/.npm/_logs/2025-10-13T16_08_40_447Z-eresolve-report.txt
npm error A complete log of this run can be found in: /Users/lawrencebaldwin/.npm/_logs/2025-10-13T16_08_40_447Z-debug-0.log
└  Operation failed.

解决方法 #

• 直接带参数创建项目：执行命令时传递--legacy-peer-deps给npm，跳过peer依赖校验：

  npx sv create -- --legacy-peer-deps
  

  注：--用于将后续参数传递给脚手架内部的npm install命令。

• 手动安装依赖：先创建项目但不自动安装依赖，再手动指定参数安装：

  1. 创建项目：

     npx sv create --no-install
     

  2. 进入项目目录：

     cd 你的项目名称
     

  3. 手动安装依赖：

     npm install --legacy-peer-deps
     

• 更新npm版本：旧版本npm可能存在依赖解析问题，更新到最新版后重试：

  npm install -g npm@latest
  

• 清除npm缓存：缓存损坏也可能导致异常，清除后再尝试创建：

  npm cache clean --force
  

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