首頁·報錯訊息

tsc 4.9+ · 建置與型別

報錯原文

error TS18048: 'user' is possibly 'undefined'.

這是什麼意思

這個值可能是 undefined,而你沒有處理這種可能;這是 tsc 替你提前抓住了一個將來的 Cannot read properties of undefined。它出現在可選欄位、陣列 find() 的結果,以及可能沒設定的環境變數上。解決辦法是決定「它不存在時怎麼辦」:在函式開頭用 if (!user) return null 早退,或者用 user?.name 短路。寫成 user!.name 壓掉,等於宣告「我保證它存在」——保證一錯,它就以執行時例外回來,而且不留下檢查本會留下的任何安全網。

怎麼修

這個沒有一行命令能解決。說明裡寫了該看哪裡。

來自
tsc 4.9+
建置與型別
10

建置階段的錯誤是工具在執行之前就先拒絕了,所以它們出現的那一刻並不弄壞什麼——但它們問你兩個問題:你要把型別或路徑改成和真實結構一致,還是用一個 as any、一條抑制註解讓那一行過去?也正是在這裡,那些只在你自己機器上成立的事情——大小寫、副檔名、環境變數——第一次顯形。

怎麼讀報錯

  • 從第一行往下讀。越往下越是工具內部的事,起因通常寫在最上面。
  • 有檔名和行號就從那裡查——不是堆疊最上面那一格,而是最上面那條提到你自己寫的檔案的行。
  • 把報錯原文照樣去搜,但先去掉你自己的路徑和變數名,正是那些讓搜尋比對不上。
  • 同一種情況在不同版本裡措辭不同。結果不對頭,就把版本號一起加進查詢。
  • 貼上修法之前,先確認它會丟掉什麼。這裡面有些是不能收回的。

常見問題

Q. “error TS18048: 'user' is possibly 'undefined'.” 是什麼意思?

這個值可能是 undefined,而你沒有處理這種可能;這是 tsc 替你提前抓住了一個將來的 Cannot read properties of undefined。它出現在可選欄位、陣列 find() 的結果,以及可能沒設定的環境變數上。解決辦法是決定「它不存在時怎麼辦」:在函式開頭用 if (!user) return null 早退,或者用 user?.name 短路。寫成 user!.name 壓掉,等於宣告「我保證它存在」——保證一錯,它就以執行時例外回來,而且不留下檢查本會留下的任何安全網。

Q. 怎麼修?

沒有一行命令能解決。上面的說明寫了該看哪裡。

Q. 這是哪個工具報的?

tsc 4.9+。它屬於建置與型別,報錯原文有 6 個詞。

相關報錯