Node.js作为一款基于Chrome V8引擎的JavaScript运行时,让开发者能够脱离浏览器环境运行JavaScript代码,广泛应用于后端开发、工具链构建、自动化脚本等领域,要使用Node.js,首先需要掌握如何在命令行(也称为终端、Shell)中打开并运行它,本文将从准备工作、不同操作系统下的命令行打开方式、Node.js命令验证、常用命令及常见问题解决等方面,详细讲解Node.js命令行的使用方法。

准备工作:安装Node.js
在打开Node.js命令行之前,确保你的电脑已安装Node.js,Node.js的安装非常简单,访问Node.js官网,下载适合你操作系统的LTS(长期支持)版本,Windows用户可下载.msi安装包,双击运行按提示安装;macOS用户可下载.pkg安装包,或使用Homebrew命令brew install node;Linux用户(如Ubuntu)可通过sudo apt update && sudo apt install nodejs npm安装,安装过程中,务必勾选“Add to PATH”选项(Windows)或确保环境变量自动配置(macOS/Linux),这样才能在命令行中直接使用node和npm命令。
不同操作系统下打开命令行的方式
不同操作系统的命令行工具名称和打开方式略有差异,以下是主流操作系统的具体操作方法,可参考下表:
| 操作系统 | 命令行工具名称 | 打开方法 | 快捷键/备注 |
|---|---|---|---|
| Windows | 命令提示符(CMD) | 按Win+R输入cmd回车 |
适用于Windows 7及以上版本,基础命令行工具 |
| Windows | PowerShell | 按Win+X选择“Windows PowerShell”或“终端” |
Windows 10/11推荐,功能更强大,支持脚本 |
| macOS | 终端(Terminal) | 按Command+空格输入“终端”回车,或通过“应用程序”>“实用工具”打开 |
macOS默认命令行工具,基于Zsh/Bash |
| Linux | 终端(Terminal) | 按Ctrl+Alt+T(Ubuntu等发行版),或通过应用程序菜单打开 |
不同发行版名称可能不同(如Ubuntu叫“终端”,CentOS叫“控制台”),功能类似 |
补充说明:
- Windows用户若使用较新版本(Windows 11/10 1903+),可直接搜索“终端”(Terminal),它集成了CMD、PowerShell和Azure Cloud Shell,支持标签页切换,体验更佳。
- macOS用户若使用Zsh(默认Shell),可编辑
~/.zshrc文件配置环境变量;若使用Bash,则编辑~/.bash_profile或~/.bashrc。 - Linux用户若使用非root用户,执行某些命令时需加
sudo获取管理员权限。
验证Node.js安装
打开命令行后,需验证Node.js是否正确安装并配置环境变量,依次输入以下两个命令:
node -v:显示Node.js版本号,例如v18.17.0。npm -v:显示npm(Node.js包管理器)版本号,例如6.7。
若两个命令均返回版本号,说明安装成功;若提示“不是内部或外部命令”,则可能是环境变量未配置,需重新检查Node.js安装路径是否添加到系统PATH中(Windows可在“系统属性”>“高级”>“环境变量”中配置;macOS/Linux需编辑对应Shell配置文件,添加export PATH=$PATH:/usr/local/bin,具体路径以实际安装路径为准)。
Node.js命令行常用操作
运行JavaScript文件
在命令行中,使用node 文件名.js命令执行JavaScript文件,若有一个名为hello.js的文件,内容为:

console.log("Hello, Node.js!");
在命令行中进入文件所在目录(使用cd命令,如cd C:UsersNameDesktop),输入node hello.js,即可输出Hello, Node.js!。
进入Node.js交互模式(REPL)
直接在命令行输入node并回车,进入交互模式(Read-Eval-Print Loop),可逐行输入JavaScript代码并立即执行。
> console.log("在交互模式中运行");
在交互模式中运行
> 1 + 1
2
>
输入.exit或按Ctrl+C可退出交互模式。
使用npm管理包
npm是Node.js的包管理器,常用命令包括:
npm init:初始化项目,生成package.json配置文件(加-y可跳过交互,直接生成默认配置)。npm install 包名:安装指定包,如npm install express安装Express框架;加-g可全局安装(如npm install -g nodemon,nodemon用于自动重启服务)。npm run 脚本名:运行package.json中scripts定义的脚本,如npm start、npm test。npm list:查看已安装的包列表。
使用npx运行临时包
npx是npm包运行工具,可临时安装并运行包,无需全局安装。npx create-react-app my-app会临时安装create-react-app并创建React项目,完成后自动删除临时包。
常见问题及解决方法
问题:“node不是内部或外部命令”
原因:Node.js安装路径未添加到系统环境变量PATH中。
解决:

- Windows:右键“此电脑”>“属性”>“高级系统设置”>“环境变量”,在“系统变量”中找到
Path,编辑并添加Node.js安装路径(如C:Program Filesnodejs)。 - macOS/Linux:打开Shell配置文件(如
~/.zshrc),添加export PATH=$PATH:/usr/local/bin(假设Node.js安装在/usr/local/bin),保存后运行source ~/.zshrc使配置生效。
问题:macOS/Linux下执行npm命令提示权限错误
原因:直接使用sudo安装npm包可能导致权限问题,且不安全。
解决:
- 方案1:配置npm全局安装路径为用户目录,避免系统权限,执行:
mkdir ~/.npm-global npm config set prefix '~/.npm-global' echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc # 或~/.bashrc source ~/.zshrc
之后全局安装的包会存放在
~/.npm-global中,无需sudo。 - 方案2:若必须使用sudo,可先执行
sudo chown -R $USER /usr/local/lib/node_modules修复权限,但不推荐长期使用。
相关问答FAQs
Q1:Node.js命令行和普通命令行(如CMD、Terminal)有什么区别?
A1:普通命令行是操作系统提供的交互式界面,用于执行系统命令(如dir、ls、cd);而Node.js命令行是在普通命令行基础上,通过安装Node.js后,新增了node和npm等命令,用于运行JavaScript代码、管理Node.js包,Node.js命令行是普通命令行的“扩展”,增加了JavaScript运行环境。
Q2:如何在命令行中退出Node.js交互模式?
A2:在Node.js交互模式(REPL)中,可通过以下方式退出:
- 输入
.exit并回车; - 按快捷键
Ctrl+C(连续按两次); - 按快捷键
Ctrl+D(Linux/macOS适用)。
退出后会返回普通命令行界面。
原创文章,发布者:酷番叔,转转请注明出处:https://cloud.kd.cn/ask/16782.html