本地Windows机器上Playwright Percy视觉对比无法运行求助

云上老周

2026-7-6

解决Windows下Playwright Percy运行时"Missing Percy token"错误的方案

修正环境变量设置语法
Windows不同终端的环境变量设置语法有差异，且不能带多余引号：
- CMD命令提示符下执行：
```
set PERCY_TOKEN=web...
set PERCY_BRANCH=local
```
- PowerShell下执行：
```
$env:PERCY_TOKEN = "web..."
$env:PERCY_BRANCH = "local"
```
（此前添加的引号会被当作变量值的一部分，导致Percy无法识别有效Token）
验证环境变量是否生效
设置完成后立即在同一终端验证：
- CMD：执行 echo %PERCY_TOKEN%
- PowerShell：执行 echo $env:PERCY_TOKEN
  确认输出为纯净的Token内容，无多余引号或字符。
改用.env文件配置（更稳定）
1. 在项目根目录创建.env文件，写入：
```
PERCY_TOKEN=web...
PERCY_BRANCH=local
```
2. 安装dotenv依赖：
```
npm install dotenv --save-dev
```
3. 在playwright.config.js（或对应配置文件）顶部添加：
```
require('dotenv').config();
```
此方式会直接从文件加载环境变量，避免终端会话变量失效问题。
检查终端会话与权限
- 确保设置变量后在同一终端执行npm run test，不要切换窗口或重启终端（除非重新设置变量）
- 若使用VS Code集成终端，可重启VS Code后重新配置变量再执行测试。
确认Percy Token有效性
登录Percy平台，核对项目Token是否完整复制，无遗漏、空格或多余字符。