引入

Node.js 项目不是只创建一个 .js 文件。依赖版本、启动命令和项目元数据如果没有统一记录,换一台机器就可能无法复现。因此,开发通常从版本检查和 package.json 开始。

正文

检查环境

node --version
npm --version

团队开发应统一 Node.js 主版本,可以使用版本管理工具或项目约定文件固定版本范围。

创建项目

mkdir demo-node
cd demo-node
npm init -y

package.json 记录项目名称、版本、入口文件、脚本和依赖。添加最小脚本:

{
  "scripts": {
    "start": "node src/index.js",
    "dev": "node --watch src/index.js"
  }
}

安装依赖

npm install <package>

运行项目脚本:

npm run start
npm run dev

dependencies 是运行项目需要的依赖,devDependencies 是开发、测试或构建阶段需要的工具。package-lock.json 用来锁定实际解析出的依赖版本,应与 package.json 一起提交。

安装已有项目

npm ci

npm ci 适合 CI 或需要严格复现依赖的环境;它要求锁定文件与 package.json 匹配,并会重新安装依赖。

引出

依赖能安装只是开始,还要关注 Node.js 版本、锁定文件和启动脚本是否一致。项目初始化完成后,可以继续理解 Nodejs模块系统,再把代码拆成清晰的模块。