Node.js / 系统课时
运行第一个 Node.js 程序
运行第一个 Node.js 程序
这一课把一个普通 JavaScript 文件真正交给 Node.js 执行。完成后,你会创建一个可直接运行的脚本,用 node 命令启动它,并能根据终端输出判断程序是否执行成功以及常见失败发生在哪一步。
学习目标
- 创建一个最小的 Node.js JavaScript 文件并从终端运行。
- 看懂文件执行、标准输出和进程结束之间的基本关系。
- 能定位命令不可用、路径错误和 JavaScript 语法错误三类常见问题。
创建可执行的 JavaScript 文件
新建目录 node-first-app,在其中创建 hello.js。Node.js 直接执行 JavaScript 文件,不要求先建立 HTML 页面,也不需要浏览器中的 script 标签。下面程序只使用 Node.js 可直接执行的标准 JavaScript 和全局 process 对象。
const user = "Anystack";
console.log(`Hello, ${user}!`);
console.log(`Node.js process id: ${process.pid}`);预期结果:保存文件本身不会产生终端输出;程序要在下一步交给 node 命令执行。process.pid 是当前进程的动态 ID,因此每次运行得到的数字可能不同。
从终端运行程序
先让终端进入 hello.js 所在目录,再执行文件。macOS、Linux、Windows PowerShell 和 Windows Terminal 中都可以直接使用下面的 Node.js 命令;前提是安装 Node.js 时已将其加入系统 PATH。
node hello.js预期输出
Hello, Anystack!
Node.js process id: <ID><ID> 表示实际进程 ID,每次运行都可能不同。两行输出完成后,如果程序中没有定时器、服务器监听、未完成的异步任务等继续占用事件循环的工作,Node.js 进程会自动结束并把控制权交还给终端。
理解 Node.js 怎样执行这个文件
执行 node hello.js 时,Node.js 会读取目标文件并执行其中的 JavaScript。代码从文件顶层开始运行,console.log() 把文本写入标准输出;当同步代码已经执行完,而且没有需要继续等待的异步工作时,进程自然退出。
可以用退出码验证一次正常运行。在 macOS 或 Linux 的 Bash 中,程序执行结束后运行 echo $?;正常结束通常得到 0。在 PowerShell 中可查看 $LASTEXITCODE。实际项目里的 CI、部署脚本和进程管理器都会利用退出码判断一次执行是否成功。
如果脚本需要明确告诉外部工具“执行失败”,通常设置 process.exitCode,而不是在业务代码中随意调用 process.exit()。例如把 process.exitCode = 1 放在错误处理路径中,Node.js 会在现有同步代码及可完成的清理结束后以非零状态退出。
按现象定位运行失败
如果终端提示 node 不是可识别的命令或出现 command not found,先执行 node --version。同样失败说明问题在 Node.js 安装或 PATH,而不是 hello.js;应先修复环境,再检查程序源码。
如果出现 Cannot find module '<PATH>/hello.js',通常是当前工作目录不对或文件名写错。先确认终端所在目录中确实存在 hello.js,注意 Linux 和部分 macOS 文件系统会区分文件名大小写,Hello.js 与 hello.js 可能不是同一个文件。
如果 Node.js 报 SyntaxError,应优先查看错误信息中的文件、行号和插入符号位置。例如漏掉字符串结束引号时,运行会在解析阶段失败,程序中的 console.log() 甚至还没有机会执行。修正语法后重新运行同一条 node hello.js,看到两行预期输出即可完成验收。