深入解析package.json：必备指南
package.json 概述
package.json 是 Node.js 项目的核心配置文件，用于定义项目元数据、依赖项、脚本命令及其他配置。它采用 JSON 格式，通常位于项目根目录中，是 npm 或 yarn 等包管理工具的基础。
核心字段解析
name
定义项目名称，需符合 npm 命名规则（小写、无空格、允许连字符）。私有项目可任意命名，但发布到公共仓库时需确保唯一性。
version
遵循语义化版本规范（SemVer），格式为 主版本.次版本.修订号。例如 1.0.0 表示初始稳定版本。
description
项目的简短描述，通常用于 npm 仓库展示，帮助其他开发者快速了解项目用途。
main
指定项目的入口文件，默认为 index.js。当其他代码通过 require 或 import 引用该包时，会加载此文件。
scripts
定义可运行的命令行脚本。例如：
"scripts": {
"start": "node app.js",
"test": "jest"
}
通过 npm run <script-name> 执行，如 npm run test。
dependencies
列出项目运行时必需的依赖包，格式为 包名: 版本范围。例如：
"dependencies": {
"react": "^18.2.0"
}
^ 表示兼容次版本更新，~ 表示仅兼容修订号更新。
devDependencies
仅开发阶段需要的依赖（如测试工具、构建工具）。通过 npm install --save-dev 添加。
peerDependencies
声明宿主环境必须提供的依赖版本，常见于插件开发。例如：
"peerDependencies": {
"webpack": "^5.0.0"
}
高级配置字段
engines
指定运行环境要求，如 Node.js 或 npm 的版本：
"engines": {
"node": ">=16.0.0",
"npm": ">=8.0.0"
}
browserslist
定义前端项目的目标浏览器兼容范围，被 Babel、Autoprefixer 等工具使用：
"browserslist": [
"> 1%",
"last 2 versions"
]
private
设为 true 可防止项目被意外发布到 npm 仓库。
workspaces
用于 monorepo 项目，定义子包路径：
"workspaces": [
"packages/*"
]
依赖版本控制符号
^1.2.3：允许次版本和修订号更新（如 1.2.4、1.3.0）。~1.2.3：仅允许修订号更新（如 1.2.4）。1.2.3：锁定精确版本。latest：始终安装最新版本（不推荐）。
生成与维护
通过 npm init 交互式生成 package.json，或直接手动创建。更新依赖时使用 npm update 或 yarn upgrade。
常见问题
依赖冲突
使用 npm ls 分析依赖树，或通过 resolutions 字段（yarn）强制指定版本。
脚本钩子
利用 pre 和 post 前缀定义生命周期脚本，如 prepublish、postinstall。
环境变量
在脚本中通过 cross-env 跨平台设置环境变量：
"scripts": {
"build": "cross-env NODE_ENV=production webpack"
}
BbS.okacop030.info/PoSt/1120_918278.HtM
BbS.okacop031.info/PoSt/1120_795468.HtM
BbS.okacop032.info/PoSt/1120_345223.HtM
BbS.okacop033.info/PoSt/1120_459741.HtM
BbS.okacop034.info/PoSt/1120_636081.HtM
BbS.okacop035.info/PoSt/1120_112114.HtM
BbS.okacop036.info/PoSt/1120_642112.HtM
BbS.okacop037.info/PoSt/1120_684200.HtM
BbS.okacop038.info/PoSt/1120_805886.HtM
BbS.okacop039.info/PoSt/1120_655088.HtM
BbS.okacop030.info/PoSt/1120_564843.HtM
BbS.okacop031.info/PoSt/1120_978229.HtM
BbS.okacop032.info/PoSt/1120_897915.HtM
BbS.okacop033.info/PoSt/1120_410396.HtM
BbS.okacop034.info/PoSt/1120_769607.HtM
BbS.okacop035.info/PoSt/1120_402726.HtM
BbS.okacop036.info/PoSt/1120_737399.HtM
BbS.okacop037.info/PoSt/1120_324437.HtM
BbS.okacop038.info/PoSt/1120_809481.HtM
BbS.okacop039.info/PoSt/1120_474275.HtM
BbS.okacop030.info/PoSt/1120_982190.HtM
BbS.okacop031.info/PoSt/1120_871806.HtM
BbS.okacop032.info/PoSt/1120_724018.HtM
BbS.okacop033.info/PoSt/1120_959063.HtM
BbS.okacop034.info/PoSt/1120_013829.HtM
BbS.okacop035.info/PoSt/1120_627099.HtM
BbS.okacop036.info/PoSt/1120_484561.HtM
BbS.okacop037.info/PoSt/1120_627487.HtM
BbS.okacop038.info/PoSt/1120_343582.HtM
BbS.okacop039.info/PoSt/1120_345992.HtM
BbS.okacop030.info/PoSt/1120_922124.HtM
BbS.okacop031.info/PoSt/1120_839504.HtM
BbS.okacop032.info/PoSt/1120_350443.HtM
BbS.okacop033.info/PoSt/1120_711029.HtM
BbS.okacop034.info/PoSt/1120_059730.HtM
BbS.okacop035.info/PoSt/1120_459854.HtM
BbS.okacop036.info/PoSt/1120_831314.HtM
BbS.okacop037.info/PoSt/1120_305131.HtM
BbS.okacop038.info/PoSt/1120_582429.HtM
BbS.okacop039.info/PoSt/1120_393574.HtM
BbS.okacop030.info/PoSt/1120_191214.HtM
BbS.okacop031.info/PoSt/1120_314271.HtM
BbS.okacop032.info/PoSt/1120_162946.HtM
BbS.okacop033.info/PoSt/1120_756608.HtM
BbS.okacop034.info/PoSt/1120_050177.HtM
BbS.okacop035.info/PoSt/1120_999981.HtM
BbS.okacop036.info/PoSt/1120_178566.HtM
BbS.okacop037.info/PoSt/1120_581083.HtM
BbS.okacop038.info/PoSt/1120_250554.HtM
BbS.okacop039.info/PoSt/1120_551121.HtM
BbS.okacop040.info/PoSt/1120_185695.HtM
BbS.okacop041.info/PoSt/1120_445741.HtM
BbS.okacop042.info/PoSt/1120_029017.HtM
BbS.okacop043.info/PoSt/1120_331253.HtM
BbS.okacop044.info/PoSt/1120_773481.HtM
BbS.okacop045.info/PoSt/1120_763144.HtM
BbS.okacop046.info/PoSt/1120_060703.HtM
BbS.okacop047.info/PoSt/1120_037312.HtM
BbS.okacop048.info/PoSt/1120_355762.HtM
BbS.okacop049.info/PoSt/1120_934063.HtM
BbS.okacop040.info/PoSt/1120_948869.HtM
BbS.okacop041.info/PoSt/1120_072544.HtM
BbS.okacop042.info/PoSt/1120_731052.HtM
BbS.okacop043.info/PoSt/1120_340345.HtM
BbS.okacop044.info/PoSt/1120_683304.HtM
BbS.okacop045.info/PoSt/1120_806344.HtM
BbS.okacop046.info/PoSt/1120_837979.HtM
BbS.okacop047.info/PoSt/1120_112980.HtM
BbS.okacop048.info/PoSt/1120_931506.HtM
BbS.okacop049.info/PoSt/1120_270947.HtM
BbS.okacop040.info/PoSt/1120_481781.HtM
BbS.okacop041.info/PoSt/1120_837858.HtM
BbS.okacop042.info/PoSt/1120_611234.HtM
BbS.okacop043.info/PoSt/1120_911353.HtM
BbS.okacop044.info/PoSt/1120_993350.HtM
BbS.okacop045.info/PoSt/1120_266772.HtM
BbS.okacop046.info/PoSt/1120_132109.HtM
BbS.okacop047.info/PoSt/1120_508733.HtM
BbS.okacop048.info/PoSt/1120_096977.HtM
BbS.okacop049.info/PoSt/1120_948071.HtM
