如何解决Mac系统下执行npm install sqlite3命令时报错的问题
2026-9-24
报错根因
你使用的sqlite3@3.32.3为2020年发布的旧版本，未提供适配ARM架构Mac（M系列芯片）的预编译二进制包，npm安装时会自动触发源码编译流程，而源码编译依赖Xcode命令行工具提供的编译环境，缺少该组件就会触发你遇到的报错。
解决方案
方案1：仅安装轻量Xcode命令行工具（推荐，适配固定3.32.3版本需求）
不需要下载十几G的完整Xcode，仅需安装几百MB的命令行工具即可：
- 终端执行命令：
xcode-select --install - 在弹出的安装弹窗中按照指引完成安装
- 安装完成后重新执行
npm install sqlite3即可正常编译安装
方案2：升级sqlite3到适配版本（无需安装任何开发工具）
5.0.0及以上版本的sqlite3已经提供了适配ARM架构Mac的预编译包，不需要本地编译就能直接安装：
- 先清理残留的失败安装文件：
npm uninstall sqlite3 - 执行安装命令：
npm install sqlite3@latest
注意：如果你的项目强制要求锁定3.32.3版本，该方案不适用
方案3：更换为纯JS实现的sqlite替代包（完全不需要编译环境）
如果不想安装任何开发组件，可以换用纯JS实现的sqlite兼容包，无需编译直接运行：
- 安装命令：
npm install sql.js
内容的提问来源于stack exchange，提问作者ryan
相关产品推荐
相关产品推荐
