一、问题/场景描述
在运行或编译Node.js项目时，开发者常常会遇到“Unexpected token”错误。该错误通常会导致程序突然终止，控制台会打印出具体的错误行和列信息，指示JavaScript引擎遇到了一个无法解析的语法标记。
二、原因分析
“Unexpected token”错误的根本原因是Node.js的JavaScript引擎（通常是V8）无法识别或解析代码中的某个语法结构。这主要源于几个方面：首先，代码中可能存在简单的语法错误，如括号、引号不匹配。其次，也是最常见的原因，是代码中使用了当前Node.js版本不支持的ECMAScript新语法（如ES6及以上版本的特性）。此外，文件编码问题或文件意外损坏也可能导致引擎将正常字符误判为非法标记。
三、详细解决步骤
解决此错误需要根据具体原因进行排查和修复，请按以下步骤操作。
步骤1：检查并修复基础语法错误
首先，仔细查看控制台报错信息指出的文件和具体行、列位置。检查该位置附近是否存在明显的语法错误。
// 错误示例：缺少右括号或使用了中文标点
console.log(‘Hello World‘; // 使用了中文单引号且缺少右括号
// 正确应为：
console.log('Hello World');步骤2：确认并升级Node.js版本
如果代码中使用了较新的JavaScript语法（如可选链操作符?.、空值合并运算符??、import/export模块语法等），而Node.js版本过低，则会导致此错误。请检查并升级Node.js。
# 查看当前Node.js版本
node -v
# 使用nvm（Node Version Manager）升级到最新的LTS版本
nvm install --lts
nvm use --lts步骤3：配置Babel转译器（如需兼容旧版本）
如果项目需要兼容旧版Node.js环境，则需要使用Babel将新语法转译为旧版本兼容的ES5语法。首先安装必要的Babel包。
npm install --save-dev @babel/core @babel/cli @babel/preset-env然后，在项目根目录创建或修改.babelrc配置文件。
{
"presets": ["@babel/preset-env"]
}最后，通过Babel CLI转译你的源代码，或使用babel-node直接运行。
# 转译src目录下的代码到lib目录
npx babel src --out-dir lib
# 使用babel-node直接运行（需安装@babel/node）
npx babel-node your-script.js步骤4：检查文件编码与完整性
对于非语法和版本问题，检查文件编码是否为UTF-8，并确保文件没有损坏。可以使用文本编辑器（如VS Code）查看和更改编码。
# 在Linux/macOS下，可以使用file命令查看文件编码
file -i your-file.js四、注意事项
在解决“Unexpected token”错误时，务必首先精确定位报错位置。升级Node.js版本通常是解决新语法问题最直接的方法。如果使用Babel，请确保配置文件正确，并且生产环境部署的是转译后的代码，而非源代码。
五、适用环境
本文适用于所有使用Node.js进行开发的场景，包括Web服务器、命令行工具、构建脚本等。