Node.js 作为一款基于 Chrome V8 引擎的 JavaScript 运行时,凭借其事件驱动、非阻塞 I/O 的特性,成为服务器端开发的主流工具之一,掌握 Node.js 命令是高效开发的基础,从环境安装到项目调试,再到包管理,每个命令都发挥着重要作用,以下将详细介绍 Node.js 的常用命令,涵盖全局安装、本地运行、包管理、调试等多个场景,帮助开发者全面掌握 Node.js 的命令行操作。

Node.js 安装与环境验证命令
在使用 Node.js 之前,首先需要确保环境已正确安装,通过以下命令可验证安装状态:
node -v
或node --version
:查看 Node.js 当前安装版本,例如输出v18.17.0
表示安装成功。npm -v
或npm --version
:查看 npm(Node.js 包管理器)的版本,npm 会随 Node.js 自动安装,用于管理项目依赖。
若命令提示“不是内部或外部命令”,需检查 Node.js 安装路径是否已添加到系统环境变量 PATH 中。
Node.js 脚本运行命令
开发过程中,最常用的命令是执行 JavaScript 脚本文件:
node 文件名.js
:在当前终端运行指定的 JavaScript 文件,执行node server.js
会启动一个基于 Node.js 的服务器。node -e "代码字符串"
:直接在命令行执行一段 JavaScript 代码,无需创建文件。node -e "console.log('Hello, Node.js!')"
会在终端输出 Hello, Node.js!。node -i
:进入交互式模式(REPL),可在命令行直接输入 JavaScript 代码并实时查看执行结果,适合快速测试代码片段。
npm 包管理命令
npm 是 Node.js 生态的核心,用于安装、更新、删除和管理项目依赖,主要分为全局安装和本地安装两类:

全局安装(安装到系统环境,所有项目可用)
npm install -g 包名
或npm i -g 包名
:全局安装指定包,npm i -g yarn
安装包管理器 yarn。npm uninstall -g 包名
:全局卸载指定包,npm uninstall -g gulp
卸载构建工具 gulp。npm list -g --depth=0
:查看全局已安装的包及版本(--depth=0
表示不显示依赖的子包)。
本地安装(安装到当前项目)
npm install 包名
或npm i 包名
:本地安装包到项目目录下的node_modules
文件夹,并添加到package.json
的dependencies
(生产依赖)中。npm install --save-dev 包名
或npm i -D 包名
:安装为开发依赖,添加到package.json
的devDependencies
中,例如测试框架 jest、代码格式化工具 prettier。npm install 包名@版本号
:安装指定版本的包,npm i lodash@4.17.21
安装 lodash 的 4.17.21 版本。npm uninstall 包名
:卸载本地包,同时从package.json
中移除依赖。
项目初始化与依赖管理
npm init
或npm init -y
:初始化 Node.js 项目,生成package.json
配置文件。-y
参数表示使用默认配置,无需手动输入信息。npm install
:根据项目根目录的package.json
文件安装所有依赖(包括dependencies
和devDependencies
),通常用于项目克隆后的依赖恢复。npm update 包名
:更新指定包到最新兼容版本(遵循package.json
中的版本约束)。npm outdated
:检查项目中是否有依赖包存在过时版本,并显示当前版本、最新版本等信息。
npm 脚本命令
package.json
中的 scripts
字段定义了可执行的脚本命令,通过 npm run 脚本名
调用:
npm start
:启动项目,默认执行package.json
中scripts
的start
字段(如"start": "node server.js"
)。npm test
:运行测试,默认执行scripts
中的test
字段。npm run build
:执行自定义构建脚本,"build": "webpack --mode production"
。npm run dev
:启动开发环境,"dev": "nodemon server.js"
(nodemon 可监听文件变化并自动重启服务)。
Node.js 调试与性能分析命令
开发过程中,调试和性能优化至关重要,Node.js 提供了内置的调试工具:
node --inspect 文件名.js
:启动 Node.js 进程并开启调试模式,默认监听端口 9229,之后可通过 Chrome 浏览器访问chrome://inspect
或使用 VS Code 的调试功能连接调试。node --inspect-brk 文件名.js
:与--inspect
类似,但在代码第一行断开,方便设置断点调试。node --prof 文件名.js
:启用 V8 引擎的性能分析,生成.cpuprofile
文件,可通过node --prof-process isolate-0xnnnnnnnnnnnn-v8.log
分析 CPU 性能瓶颈。node --trace-warnings 文件名.js
:输出所有警告信息,帮助排查潜在问题。
其他实用命令
node --trace-events-enabled 文件名.js
:启用跟踪事件,配合 Chrome DevTools 的 Performance 面板分析运行时性能。node --max-old-space-size=4096 文件名.js
:设置 Node.js 进程的最大内存为 4096MB(默认约 1.4GB),适用于处理大内存任务时避免内存溢出。npx 包名
:临时执行指定包(无需全局安装),npx create-react-app my-app
创建 React 项目,或npx eslint src/
运行代码检查。
相关问答 FAQs
问题 1:npm install 和 npm install --save-dev 有什么区别?
解答:npm install
(或 npm i
)默认安装的包会被添加到 package.json
的 dependencies
字段,表示这些包是项目运行时必需的依赖(如 Express 框架、数据库驱动等),而 npm install --save-dev
(或 npm i -D
)安装的包会被添加到 devDependencies
字段,表示这些包仅用于开发阶段(如测试工具、代码打包工具、代码格式化工具等),不会随项目发布到生产环境,两者的核心区别在于依赖的用途和运行环境。
问题 2:如何解决 npm install 速度慢或失败的问题?
解答:npm 安装速度慢或失败通常与默认 registry 源(registry.npmjs.org)在国内访问较慢有关,解决方案包括:

- 切换国内镜像源:使用淘宝镜像源(https://registry.npmmirror.com),执行命令
npm config set registry https://registry.npmmirror.com
,之后可通过npm config get registry
验证是否切换成功。 - 使用 cnpm:安装淘宝定制的 cnpm 工具(
npm install -g cnpm --registry=https://registry.npmmirror.com
),之后用cnpm install
替代npm install
。 - 配置代理:如果通过代理网络访问,需配置 npm 代理:
npm config set proxy http://proxy-server:port
和npm config set https-proxy http://proxy-server:port
。 - 清理缓存:若缓存损坏导致失败,可执行
npm cache clean --force
清理 npm 缓存后重试。