Node.js 常用命令

以下是 Node.js 开发中常用的命令分类整理，涵盖包管理、脚本执行、模块管理、调试及环境配置等方面：

初始化项目

npm init # 交互式生成 package.json npm init -y # 使用默认配置快速生成
安装依赖

npm install <pkg> # 安装包（默认 --save） npm install <pkg>@<ver> # 安装指定版本（如 npm install express@4.18） npm install -D <pkg> # 安装开发依赖（--save-dev） npm install -g <pkg> # 全局安装 npm install # 安装所有 package.json 中的依赖
卸载依赖

npm uninstall <pkg> # 卸载并从 package.json 移除 npm uninstall -g <pkg> # 卸载全局包
更新依赖

npm update # 更新所有依赖到最新兼容版本 npm outdated # 查看过期的依赖
其他包管理命令

npm list # 查看已安装的依赖树 npm list -g --depth=0 # 查看全局安装的顶层包 npm cache clean --force # 清理缓存

运行 package.json 中的脚本

npm run <script> # 如 npm run dev/start/build npm start # 快捷运行 start 脚本 npm test # 快捷运行 test 脚本
直接执行 Node.js 文件

node app.js # 运行 JavaScript 文件 node -e "console.log('Hello')" # 执行内联代码
使用 npx 执行包命令

npx create-react-app my-app # 临时安装并执行包命令（无需全局安装） npx http-server # 启动临时 HTTP 服务器

nvm（Node Version Manager）

nvm install <version> # 安装指定 Node.js 版本 nvm use <version> # 切换版本 nvm ls # 查看已安装版本 nvm alias default <ver> # 设置默认版本
npm 版本管理

npm version <ver> # 更新包版本（如 npm version 1.2.3） npm version major # 递增主版本号（1.x.x → 2.0.0） npm publish # 发布包到 npm 仓库

调试模式

node inspect app.js # 启动调试器（Chrome DevTools 协议） node --inspect app.js # 启用远程调试（默认端口 9229） node --inspect-brk app.js # 在首行暂停等待调试器连接
性能监控

node --prof app.js # 生成 V8 性能日志 node --prof-process isolate-*.log # 分析性能日志
进程管理

pm2 start app.js # 使用 PM2 启动守护进程 pm2 list # 查看运行中的进程 pm2 logs # 查看日志

环境变量

NODE_ENV=production node app.js # 设置环境变量
Node.js 选项

node --max-old-space-size=4096 app.js # 增加内存限制 node --experimental-modules app.mjs # 启用实验性 ESM 支持

查看信息

node -v # 查看 Node.js 版本 npm -v # 查看 npm 版本 node -e "console.log(process.versions)" # 查看详细版本信息
包文档

npm docs <pkg> # 打开包的文档网站 npm repo <pkg> # 打开包的 GitHub 仓库

Yarn:

yarn add <pkg> # 安装依赖 yarn remove <pkg> # 卸载依赖 yarn upgrade # 更新依赖
pnpm:

pnpm add <pkg> # 安装依赖 pnpm install # 安装所有依赖 pnpm store prune # 清理未引用的存储

根据需求选择工具，如追求速度可用 pnpm，稳定项目可用 npm，复杂进程用 pm2。