Codecademy项目执行npm install失败，寻求解决方案

我正在完成Codecademy Web开发技能路径中的「Gold Metal Metrics」项目，目标是构建一个使用SQLite的Web应用。执行npm install安装依赖时一直报错，以下是我的package.json文件：

{
  "name": "agoldmedalmetric",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "mocha",
    "webpack": "webpack",
    "start": "node server.js"
  },
  "author": "",
  "license": "ISC",
  "devDependencies": {
    "babel-core": "^6.26.0",
    "babel-loader": "^7.1.2",
    "babel-preset-es2015": "^6.24.1",
    "babel-preset-react": "^6.24.1",
    "react": "^15.6.1",
    "react-dom": "^15.6.1",
    "webpack": "^3.5.5"
  },
  "dependencies": {
    "chai": "^4.1.2",
    "cors": "^2.8.4",
    "csv-parse": "^1.2.1",
    "express": "^4.15.4",
    "fs": "0.0.1-security",
    "mocha": "^6.1.3",
    "react-router-dom": "^4.2.2",
    "sqlite3": "^4.0.6"
  }
}

错误日志核心片段：

npm ERR! code 1
npm ERR! path /Users/masonbennett/Dropbox/My Mac (Mason’s MacBook Air)/Desktop/Programming/programs/github/web_apps/project-5-gold-medal-metrics-start/node_modules/sqlite3
npm ERR! command failed
npm ERR! command sh -c node-pre-gyp install --fallback-to-build
npm ERR! ACTION deps_sqlite3_gyp_action_before_build_target_unpack_sqlite_dep Release/obj/gen/sqlite-autoconf-3310100/sqlite3.c
npm ERR! Failed to execute '/Users/masonbennett/.nvm/versions/node/v18.18.0/bin/node /Users/masonbennett/.nvm/versions/node/v18.18.0/lib/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js build --fallback-to-build --module=/Users/masonbennett/Dropbox/My Mac (Mason’s MacBook Air)/Desktop/Programming/programs/github/web_apps/project-5-gold-medal-metrics-start/node_modules/sqlite3/lib/binding/node-v108-darwin-arm64/node_sqlite3.node --module_name=node_sqlite3 --module_path=/Users/masonbennett/Dropbox/My Mac (Mason’s MacBook Air)/Desktop/Programming/programs/github/web_apps/project-5-gold-medal-metrics-start/node_modules/sqlite3/lib/binding/node-v108-darwin-arm64 --napi_version=9 --node_abi_napi=napi --napi_build_version=0 --node_napi_label=node-v108' (1)

我尝试过更新单个依赖（比如用babel-preset-env替换babel-preset-es2015），但还是报错。想问：是否需要逐个重新安装所有包？是否需要更新初始JS文件？

核心问题定位 #

报错根源是Node.js版本（v18.18.0）和旧版sqlite3@4.0.6不兼容，旧版sqlite3的node-pre-gyp构建逻辑不支持高版本Node的ABI（应用二进制接口），导致编译失败。那些npm WARN deprecated只是依赖过时提示，不是直接导致安装失败的原因。

具体解决步骤 #

1. 调整Node.js版本
   用nvm切换到和项目依赖兼容的Node版本，比如v14.x（LTS版本，适配旧版sqlite3）：

   nvm install 14
   nvm use 14
   

   之后删除node_modules和package-lock.json，重新执行npm install。

2. 如果不想换Node版本，升级sqlite3
   卸载旧版sqlite3，安装兼容高版本Node的最新稳定版：

   npm uninstall sqlite3
   npm install sqlite3 --save
   

   注意：升级后可能需要检查项目中调用sqlite3的代码，确保API兼容（新版sqlite3的部分异步API返回Promise，旧版可能用回调，需要调整）。

3. 批量更新核心依赖（可选，解决过时警告）
   不需要逐个安装，直接更新关键依赖组：

   • Babel相关：替换旧的babel-preset-es2015为babel-preset-env，同时升级babel核心包：

     npm uninstall babel-core babel-loader babel-preset-es2015 babel-preset-react
     npm install @babel/core @babel/preset-env @babel/preset-react babel-loader@8 --save-dev
     

     然后修改项目根目录的.babelrc（如果没有就新建）：

     {
       "presets": ["@babel/preset-env", "@babel/preset-react"]
     }
     

   • React相关：升级到兼容新版Babel的React版本：

     npm uninstall react react-dom react-router-dom
     npm install react react-dom react-router-dom --save
     

   • Webpack：升级到最新稳定版，同时调整webpack配置文件（比如webpack.config.js）适配新版语法。

4. 关于初始JS文件的更新
   如果只是解决安装报错，不需要修改初始JS文件；但如果升级了React、Babel等依赖，需要检查代码中的语法是否兼容：

   • 比如新版React中ReactDOM.render已经被createRoot替代，需要调整入口文件；
   • 旧版React的组件写法（比如Component类）在新版中仍然可用，但如果用函数组件+hooks会更规范。

总结 #

优先解决sqlite3和Node版本的兼容性问题，这是安装失败的核心原因。过时依赖的警告可以后续批量处理，不需要逐个安装。如果升级依赖，才需要对应调整初始JS文件适配新API。

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