Node.js运行文件时console.log()无输出的原因及解决方法

我正在学习Node.js，编写了一个简单程序，但运行文件时终端无任何输出。不过进入Node.js REPL模式直接执行console.log('Hello')时，输出正常。

我的代码 #

function sayHello(name) {
    console.log('Hello ' + name);
}

sayHello('Mosh');

环境信息 #

• 操作系统：Windows 11
• Node.js版本：v22.12.0
• 编辑器：最新版VS Code

已执行的排查步骤 #

• 在VS Code集成终端（PowerShell和命令提示符）运行node app.js，无输出；
• 切换至CMD、Git Bash等终端运行，结果相同；
• 运行前已保存文件（Ctrl+S）；
• 重启VS Code及终端；
• 测试极简代码console.log('Hello World!')，仍无输出；
• 使用node --inspect app.js调试，未发现明显问题；
• 进入Node.js REPL模式执行console.log('Hello')，输出正常。

预期终端输出 #

Hello Mosh

问题 #

为何运行node app.js时console.log()无输出，但REPL模式下正常？可能的原因是什么，该如何解决？

排查与解决方法 #

1. 检查文件编码 #

Windows下如果脚本文件是UTF-16（Unicode）编码，Node.js可能无法正确解析执行。

• 解决：在VS Code右下角点击编码标识（比如“UTF-16 LE”），选择“通过编码保存”，切换为UTF-8后重新运行脚本。

2. 确认文件路径与文件名 #

• 确保终端当前工作目录是脚本所在目录：执行dir（CMD）或ls（Git Bash）查看是否存在app.js，如果不在，用cd 脚本所在目录路径切换后再运行node app.js。
• 检查文件实际扩展名：Windows默认隐藏已知扩展名，可能文件名实际是app.js.txt。打开文件资源管理器，开启“查看”选项卡下的“文件扩展名”，确认文件名是app.js。

3. 验证脚本是否被正确加载 #

在脚本最顶部添加一行测试代码：

console.log('脚本已加载');
function sayHello(name) {
    console.log('Hello ' + name);
}

sayHello('Mosh');

如果运行后仍无输出，说明Node.js未正确读取脚本文件，重点排查文件路径、编码或权限问题；如果有输出，再检查后续代码是否有异常（你的代码是同步逻辑，这种情况概率极低）。

4. 测试错误流输出 #

将console.log替换为console.error运行，看终端是否有输出：

console.error('Hello Mosh');

如果错误流有输出，说明标准输出可能被拦截或缓冲异常，可以尝试在代码末尾添加process.stdout.end()强制刷新输出。

5. 检查Node.js安装完整性 #

虽然REPL正常，但不排除安装文件损坏。可以重新下载对应版本的Node.js安装包，覆盖安装后再测试。

内容的提问来源于stack exchange，提问作者chang