使用Node.js v18安装Strapi时出现错误求助

针对你执行npx create-strapi-app@latest my-project时遇到的安装失败问题（Node.js v16正常、v18报错，已重装Python、Node.js等组件），以下是针对性的解决步骤：

1. 验证Strapi版本与Node18的兼容性 #

Strapi从v4.10版本开始正式支持Node.js v18，若你安装的是旧版本Strapi，可能存在兼容性问题。尝试指定兼容版本安装：

npx create-strapi-app@4.10.0 my-project

2. 修复node-gyp的环境配置 #

Node18对node-gyp的编译环境要求更严格，即使重装了Python，也可能存在环境变量配置缺失的情况：

• Windows（管理员权限执行）：

  npm config set python python3.10  # 注意：node-gyp暂不支持Python 3.11及以上版本
  npm config set msvs_version 2019
  

• macOS：

  xcode-select --install  # 确保安装Xcode命令行工具
  npm config set python python3
  

• Linux（Debian/Ubuntu系）：

  sudo apt-get install build-essential python3-dev
  npm config set python python3
  

3. 清理缓存后重新安装 #

缓存损坏可能导致依赖安装异常，执行以下命令清理后重试：

npm cache clean --force
npx create-strapi-app@latest my-project --clean

4. 换用Yarn进行安装 #

部分场景下Yarn的依赖解析逻辑更稳定，可尝试用Yarn替代npm：

yarn create strapi-app my-project

5. 手动适配sqlite3版本 #

若报错与sqlite3编译相关，可先跳过自动安装，手动指定兼容Node18的版本：

1. 创建项目但跳过依赖安装：

   npx create-strapi-app@latest my-project --skip-install
   

2. 进入项目目录安装指定版本的sqlite3及剩余依赖：

   cd my-project
   npm install sqlite3@5.1.6
   npm install
   

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