package.json 是项目的“身份证”:记录名称、版本、依赖与脚本。 package.json 是项目的“身份证”:记录名称、版本、依赖与脚本。 package.json 是项目的“身份证”:记录名称、版本、依赖与脚本。
Node.js 词条目录
前端Wiki/Node.js/基础/模块系统与全局对象

npm 与 package.json

npm 是 Node 的包管理器,package.json 是项目的“身份证”:记录名称、版本、依赖与脚本。npm install 装包,npm install -S lodash 装包并写入 dependencies,npm run 脚本名 执行自定义命令。

版本号遵循语义化版本(semver):主版本.次版本.补丁,如 ^1.2.3 表示“可以装 1.x 的最新版”。依赖锁定交给 package-lock.json,它保证团队成员装到完全相同的版本。

  • npm init -y 生成 package.json;npm install xxx --save 装包并登记
  • ^1.2.3 允许 1.x 内升级,~1.2.3 只允许补丁级升级
  • package-lock.json 锁定整棵依赖树,提交它让全员版本一致
终端
# 初始化项目
npm init -y

# 安装依赖(--save / -S 写入 dependencies,开发工具用 --save-dev / -D)
npm install express --save
npm install nodemon --save-dev

# 运行 package.json 里 scripts 定义的命令
npm run dev

# package.json 关键字段
# {
#   "name": "my-app",
#   "version": "1.0.0",
#   "main": "index.js",
#   "scripts": { "dev": "nodemon index.js", "start": "node index.js" },
#   "dependencies": { "express": "^4.18.0" },
#   "devDependencies": { "nodemon": "^3.0.0" }
# }
Node
// package.json 中的 scripts 本质是快捷命令,等价于:
// "start": "node index.js"  →  npm start
// "dev": "nodemon index.js" →  npm run dev(dev 需要带 run)

// process 对象可读取 npm 注入的变量
console.log('NODE_ENV =', process.env.NODE_ENV || '未设置');
console.log('node 版本 =', process.version);
本节要点npm 管包、package.json 记录依赖与脚本、lock 文件锁定版本;scripts 让命令标准化。