npmstart.
实践指南
开始一个项目

npm start 报 Missing script: start,怎么修?

看到 Missing script: "start",先别重装 Node.js。这个错误通常意味着当前项目没有定义 start 脚本,或你运行命令的位置不对。

先确认终端在项目根目录

在编辑器中找到 package.json,并让终端进入它所在的目录。下载的仓库可能还有 frontend、web 或 apps 等子目录,真正需要启动的应用不一定在仓库最外层。npm 能找到一个 package.json,也不代表找到了你要运行的那个应用。

命令或示例
node -p "process.cwd()"
npm run

npm run 不带脚本名时会列出可运行的脚本。先看列表,再决定下一条命令。

看项目已经提供了什么脚本

常见的 Vite 项目提供 dev、build 和 preview,并不要求有 start。存在 dev 时,应运行 npm run dev。Next.js 项目里的 dev 常用于开发,start 则常用于启动已经构建好的生产服务,两者不能直接互换。

命令或示例
npm run dev

如果提示 Missing script: "dev",回到 package.json 查看实际脚本名,而不是继续猜测。

只有明确入口后,才补 start

如果这是你自己写的 Node.js 服务,并且入口确实是 server.js,可以添加下面的配置。示例只展示 scripts 字段:把它合并到现有 package.json,保留其他字段,不要整份覆盖。

配置片段
"scripts": {
  "start": "node server.js"
}

不要给所有项目都加上 vite 或 node index.js。启动命令必须与真实入口、已安装依赖和项目说明一致。

脚本存在,但可执行文件找不到

如果错误变成 vite: command not found 或某个模块找不到,这已经是另一个问题。先在正确目录安装依赖,再运行项目提供的脚本。

命令或示例
npm install
npm run dev

npm start 在缺少 start 脚本但项目根目录存在 server.js 时有默认行为。不要把这个特殊行为当成所有框架的通用启动方式。

参考资料

命令行为与框架要求会变化。使用前结合你的项目版本,核对相应官方文档。

把需求整理好,再交给 AI。

给下一次开工加上范围、命令和验收清单。

生成项目开工包

你可能接下来会用到

全部指南