项目与数据
npm
管理项目依赖与脚本
免费阅读 · 配套小练习 · 更新于
一句话理解
了解项目需要哪些软件包，以及怎样运行项目约定的命令。
打个比方
做一道菜需要用料清单和操作步骤。package.json 记录项目依赖与脚本，包管理工具负责取得和管理相应的软件包。
npm 包含软件包注册表、网站和命令行工具。常见 Node.js 项目在 package.json 中声明依赖和 scripts；npm run 后面跟脚本名来运行项目自己的命令。package-lock.json 记录依赖解析结果，npm ci 要求它与 package.json 一致，并用于按锁文件安装。不同项目的命令和运行环境并不相同。
看个例子
{
"name": "learning-page",
"private": true,
"scripts": {
"dev": "astro dev",
"build": "astro build"
}
}AI 建议执行 npm run dev 时，可以先核对 scripts 是否有 dev。本例只是配置片段；环境和依赖齐备后才可能运行。让 AI 说明命令做什么，并结合真实项目的 README 检查条件。
什么时候会遇到
- 核对 AI 建议的命令是否适用于当前项目。
- 把依赖或脚本报错交给 AI 时，补充目录、配置与环境信息。
常见误解
npm run dev 不会自动发布网站。安装依赖可能运行软件包的安装脚本；不要在不熟悉的项目中照抄命令后直接执行。
Vibe Coding 小练习 · 描述需求 → 看懂改动 → 验证结果
动手练一练：审阅 AI 给出的项目运行说明
把上方 package.json 片段交给 AI。本题只练习解释与核对，不要求安装或执行脚本。
试着这样告诉 AI
请解释这份 package.json 中如何调用预览和构建脚本，分别做什么，并列出运行前要检查的目录、环境、依赖和配置。这里只给了配置片段，请把已知信息和还需确认的条件分开；先不要安装软件包、运行脚本或修改文件。可以在你使用的 AI 编程工具中完成；也可以先对照本页代码示例，练习理解需求、识别改动和列出检查项。
跟着做
- 让 AI 根据给出的配置说明命令与前置条件。
- 自己对照 scripts，检查 dev 与 build 是否存在，以及它们对应的实际命令。
- 检查 AI 有没有承认材料不完整，并把本地预览、构建和部署区分清楚。
你应该看到
一份能与配置对应、明确前置条件的运行说明。
完成检查
- dev 对应 astro dev，build 对应 astro build，调用方式与配置一致。
- AI 没有声称示意配置已运行成功，或把预览当成上线。
遇到卡点？看提示
让 AI 引用它从配置读到的信息；缺少版本或依赖时，应标明尚未确认。
查看参考思路
调用方式是 npm run dev 与 npm run build；它们运行配置里的脚本。真实执行还需要正确目录、环境、依赖和配置。说明正确不代表命令已执行，运行结果需要单独检查。
想一想
所有项目都一定能用 npm run dev 启动吗？
查看答案
不能。先检查 package.json 是否定义 dev，再看 README 要求的包管理器、Node.js 版本与配置。