Capacitor新项目启动报错：Missing script: 'start'

问题原因 #

你创建的是纯Capacitor核心项目，未集成任何前端框架，因此package.json的scripts字段中默认没有start脚本，执行npm run start时自然找不到对应命令。

解决方案 #

方案1：添加本地静态服务器脚本（适合纯静态页面场景） #

1. 安装轻量HTTP服务器http-server：

npm install -D http-server

2. 修改package.json的scripts，添加start命令：

{
  // ...其他字段
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "start": "http-server ./ -p 8080"
  }
}

3. 再次执行npm run start即可启动本地服务器访问项目。

方案2：集成前端框架（推荐用于完整移动端应用开发） #

Capacitor通常配合前端框架使用，官方推荐的项目创建方式会自动包含start脚本：

• Vue项目：执行npm init vue@latest创建项目，完成后安装Capacitor依赖并初始化配置
• React项目：执行npx create-react-app my-app创建项目，后续添加Capacitor集成

这类项目的package.json自带start脚本，用于启动前端开发服务器。

方案3：用Capacitor命令直接预览（已有静态资源时） #

若项目已存在编译好的静态文件（默认存放在www目录），可使用Capacitor自带命令在浏览器预览：

npx cap serve

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