在 package.json 中配置项目,核心是定义元数据、依赖项和自动化脚本。你需要填写 name 和 version 以标识包,在 dependencies 或 devdependencies 中列出所需库,并在 scripts 中编写可执行的命令。这样 npm 就能正确安装环境并运行构建流程。

如何声明生产与开发依赖
通过 npm install 命令可以将库添加到 package.json 的依赖列表中。使用 --save-dev 参数会将包写入 devDependencies,适用于测试工具或构建器;不加参数则默认写入 dependencies,适用于运行时所需的库。

{
"name": "my-app",
"version": "1.0.0",
"dependencies": {
"express": "^4.18.2"
},
"devDependencies": {
"jest": "^29.7.0"
}
}
上述配置表示应用在生产环境中需要 express,而在开发阶段使用 jest 进行测试。执行 npm install 时,npm 会读取这两个字段并下载对应的包到 node_modules 目录。
如何定义和执行自定义脚本
在 scripts 字段中,你可以为常用的命令行操作定义别名。例如,将启动服务器的命令定义为 start,将代码检查定义为 lint。调用时使用 npm run 即可执行对应的 shell 命令。

{
"scripts": {
"start": "node index.js",
"build": "webpack --config webpack.config.js",
"test": "jest"
}
}
这种配置方式使得团队成员可以通过统一的命令启动项目,而不必记忆复杂的底层指令。当运行 npm run build 时,npm 会在临时 shell 中执行指定的构建工具命令。
当 scripts 中的命令报错时如何处理
如果 scripts 中定义的命令执行失败,npm 会向终端输出错误日志并返回非零退出码。这通常意味着命令本身存在语法错误或依赖缺失。你可以通过直接运行该命令来查看详细堆栈,或者检查 node_modules 中是否缺少相关依赖。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











