首頁·報錯訊息

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 個詞。

相關報錯