在React项目的package.json中，@capacitor相关包应安装为开发依赖吗？

核心结论 #

• @capacitor/core：必须放在dependencies（生产依赖）
• @capacitor/android、@capacitor/ios：建议放在devDependencies（开发依赖）

具体原因 #

1. @capacitor/core

这个包是Capacitor的核心运行时库，你的React代码会直接调用它提供的API（比如Capacitor.Plugins.Camera、Capacitor.getPlatform()等），这些代码需要在生产环境的Web应用中正常运行。如果把它放到devDependencies，打包工具（Vite、Webpack等）会在生产构建时排除它，导致应用运行时出现Cannot find module '@capacitor/core'的错误。

2. @capacitor/android、@capacitor/ios

这两个是平台专属的构建依赖，主要作用是：

• 初始化、同步原生Android/iOS项目文件
• 执行npx cap build android或npx cap build ios这类构建命令
• 提供原生项目的模板配置文件

它们的代码不会被打包到Web应用的bundle中，也不需要在生产环境的Web应用里运行。放到devDependencies可以减少生产环境的依赖体积，同时完全不影响跨平台应用的开发与构建流程。

推荐安装命令 #

# 安装核心库到生产依赖
npm install @capacitor/core

# 安装平台依赖到开发依赖
npm install -D @capacitor/android @capacitor/ios

额外提醒 #

如果你的React项目仅作为纯Web应用部署，不需要构建原生APP，那么@capacitor/android和@capacitor/ios可以直接不安装。另外，Capacitor的CLI工具@capacitor/cli也建议放在devDependencies里，它是执行Capacitor各类命令的入口。

内容的提问来源于stack exchange，提问作者Bear Bile Farming is Torture