eslint · 构建与类型
报错原文
Parsing error: Unexpected token
这是什么意思
ESLint 是在读语法的阶段就停下的,还没来得及把任何规则套到这个文件上。相比代码真的坏了,更多情况是解析器不认识这套语法——用默认解析器读 TypeScript 文件、从未开启 JSX、把装饰器或很新的语法交给了旧解析器。对准那个文件运行 npx eslint --print-config app.ts,会直接打印真正生效的 parser 和 parserOptions,所以先看它,别猜。TypeScript 需要 @typescript-eslint/parser;如果这个文件本就不该被检查,把它写进 ignores 才是正确答案。
怎么修
npx eslint --print-config app.ts- 来自
- eslint
- 构建与类型
- 10
构建阶段的错误是工具在运行之前就先拒绝了,所以它们出现的那一刻并不弄坏什么——但它们问你两个问题:你要把类型或路径改成和真实结构一致,还是用一个 as any、一条抑制注释让那一行过去?也正是在这里,那些只在你自己机器上成立的事情——大小写、扩展名、环境变量——第一次显形。
怎么读报错
- 从第一行往下读。越往下越是工具内部的事,起因通常写在最上面。
- 有文件名和行号就从那里查——不是栈顶那一帧,而是最上面那条提到你自己写的文件的行。
- 把报错原文照样去搜,但先去掉你自己的路径和变量名,正是那些让搜索匹配不上。
- 同一种情况在不同版本里措辞不同。结果不对头,就把版本号一起加进查询。
- 粘贴修法之前,先确认它会丢掉什么。这里面有些是不能撤回的。
常见问题
Q. “Parsing error: Unexpected token” 是什么意思?
ESLint 是在读语法的阶段就停下的,还没来得及把任何规则套到这个文件上。相比代码真的坏了,更多情况是解析器不认识这套语法——用默认解析器读 TypeScript 文件、从未开启 JSX、把装饰器或很新的语法交给了旧解析器。对准那个文件运行 npx eslint --print-config app.ts,会直接打印真正生效的 parser 和 parserOptions,所以先看它,别猜。TypeScript 需要 @typescript-eslint/parser;如果这个文件本就不该被检查,把它写进 ignores 才是正确答案。
Q. 怎么修?
npx eslint --print-config app.ts —— 执行前先看上面的说明,确认这条命令会丢掉什么。
Q. 这是哪个工具报的?
eslint。它属于构建与类型,报错原文有 4 个词。