解决 PowerShell 中 "&&" 不是有效语句分隔符错误

问题描述

在 Windows PowerShell 或 Visual Studio Code 的 PowerShell 终端中，尝试运行类似以下命令时：

npm run build && node ./dist/main.js

会出现以下错误信息：

The token '&&' is not a valid statement separator in this version.

这个错误通常发生在 Webpack 配置、React 项目构建或其他需要连续执行多个命令的开发场景中。

问题根源

&& 是 Linux Bash shell 中的逻辑与操作符，用于条件性顺序执行命令：只有当左侧命令成功执行（返回退出码为 0）时，才会执行右侧的命令。

Windows PowerShell 7.0 之前的版本不支持 && 和 || 操作符，这就是产生此错误的原因。

解决方案

方法一：升级 PowerShell（推荐）

升级到 PowerShell 7.0 或更高版本，这些版本已经支持 && 和 || 操作符：

1. 访问 PowerShell GitHub 发布页面
2. 下载并安装最新版本的 PowerShell
3. 在 VS Code 中设置新的 PowerShell 为默认终端

TIP

PowerShell 7+ 完全支持 && 和 || 操作符，这是最理想的长期解决方案。

方法二：使用分号分隔符

在 PowerShell 中，可以使用分号 ; 作为命令分隔符：

npm run build; node ./dist/main.js

WARNING

使用分号 ; 会无条件执行所有命令，即使前一个命令失败也会继续执行后面的命令，这与 && 的行为不同。

方法三：使用条件执行语句

如果需要保持 && 的条件执行特性，可以使用 PowerShell 的条件判断：

npm run build; if ($?) { node ./dist/main.js }

或者更健壮的版本（适用于有 stderr 重定向的情况）：

npm run build; if ($LASTEXITCODE -eq 0) { node ./dist/main.js }

方法四：使用 -and 操作符

在较旧的 PowerShell 版本中，可以使用 -and 操作符：

(npm run build) -and (node ./dist/main.js)

方法五：切换到其他终端

如果不想修改命令，可以切换到支持 && 操作符的终端：

• CMD 命令提示符：Windows 自带的命令提示符支持 &&
• Git Bash：安装 Git for Windows 后可使用类 Linux 环境的终端
• WSL：使用 Windows 子系统 for Linux

方法六：分别执行命令

最简单的解决方案是将命令分开执行：

npm run build
node ./dist/main.js

深入理解

为什么需要条件执行

在开发工作流中，条件执行非常重要。例如：

npm run build && node ./dist/main.js

这个命令确保只有在构建成功后才运行应用程序，避免了在构建失败时运行可能出错的代码。

PowerShell 中的相关变量

• $?：布尔值，表示上一个命令是否成功执行
• $LASTEXITCODE：整数，表示上一个外部程序的退出代码

最佳实践

1. 路径中避免使用空格：有时路径中的空格也可能导致问题，尽量使用无空格的目录名
2. 明确检查退出代码：对于关键操作，使用 $LASTEXITCODE -eq 0 进行精确判断
3. 保持环境一致性：在团队项目中统一开发环境，避免因终端差异导致的问题

总结

PowerShell 版本差异是导致 && 操作符错误的主要原因。根据你的具体需求和环境，可以选择升级 PowerShell、修改命令语法或切换终端来解决这个问题。对于生产环境，建议使用明确的错误检查机制来确保命令执行的可靠性。

INFO

PowerShell 7.0+ 已原生支持 && 和 || 操作符，升级到最新版本是从根本上解决问题的最佳方法。