共用方式為


針對 Visual Studio 中的 JavaScript 執行 Lint 分析

針對 Visual Studio 中的 JavaScript 和 TypeScript 執行 Lint 分析是由 ESLint 提供。 如果您剛接觸 ESLint,則可以從檢查其文件開始。

啟用 Lint 分析支援

若要在 Visual Studio 2022 或更新版本中啟用 Lint 分析,請在 [工具] > [選項] > [文字編輯器] > [JavaScript/TypeScript] > [Lint 分析] 中啟用 [啟用 ESLint] 設定。

Screenshot of linting Tools Options page.

在選項頁面中,您也可以修改您想要執行 Lint 分析的檔案集。 根據預設,所有可以執行 Lint 分析的副檔名 (.js.jsx.ts.tsx.vue.html) 都會執 Lint 分析。 必須啟用 HTML LSP 型編輯器,才能針對 Vue 和 HTML 檔案執行 Lint 分析。 可在 [工具] > [選項] > [環境] > [預覽功能] 中找到個別的設定。

您可以在某些專案類型中覆寫這些選項,例如獨立 React 專案範本。 在這些專案中,您可以使用專案屬性,從 [工具] > [選項] 頁面覆寫設定:

Screenshot of linting project properties.

安裝 ESLint 相依性

一旦啟用了 Lint 分析,就必須安裝必要的相依性。 相依性包括 ESLint npm 套件,以及適用於您專案的其他外掛程式。 可在本機將此套件安裝在您想要啟用 Lint 分析的每個專案中,或您可以使用 npm install -g eslint 進行全域安裝。 不過,不建議全域安裝,因為外掛程式和可共用的設定一律必須安裝在本機。

從 Visual Studio 2022 17.7 版 Preview 2 開始,您也可以在 [工具] [選項] [文字編輯器] > [JavaScript/TypeScript] > [Lint 分析]> 中使用 [ESLint 路徑]> 設定,來指定要從中載入 ESLint 的目錄。 當全域安裝 ESLint 時,這樣做很有用,您可能會將對應路徑設定為 C:\Program Files\nodejs\node_modules

根據您想要執行 Lint 分析的檔案,可能需要其他 ESLint 外掛程式。 例如,您可能需要 TypeScript ESLint,這可讓 ESLint 在 TypeScript 程式碼上執行,並包含額外類型資訊特有的規則。

啟用 ESLint 但找不到 ESLint npm 套件時,會顯示金色列,可讓您將 ESLint 安裝為本機 npm 開發相依性。

Screenshot of Install ESLint gold bar.

同樣地,當找不到 .eslintrc 檔案時 ,會顯示金色列以執行設定精靈,其會安裝適用於目前專案的外掛程式。

Screenshot of Run ESLint wizard gold bar.

停用 Lint 分析規則和自動修正

您可以停用特定行或檔案上的 Lint 分析錯誤。 您可以使用 [快速動作] 燈泡功能表來停用錯誤:

Screenshot of linting Quick Actions.

下圖顯示您針對所選程式碼停用 Lint 分析錯誤時的結果。

Screenshot of disabled linting rule.

此外,自動修正程式碼動作可讓您套用自動修正,來解決個別的 Lint 分析錯誤。

疑難排解

您可以在 [輸出] 視窗中開啟 [ESLint 語言延伸模組] 窗格,以查看可能說明問題的任何錯誤訊息或其他記錄。