目錄中出現(xiàn) jsconfig.json 文件表明該目錄是 JavaScript 項(xiàng)目的根目錄。 Json 文件指定了根文件和 JavaScript 語(yǔ)言服務(wù)提供的特性的選項(xiàng)。

提示: 如果你不使用 JavaScript，你不需要擔(dān)心 jsconfig.json。

提示: jsconfig.json 是 tsconfig.json 的后代，后者是 TypeScript 的配置文件。 Json 是 tsconfig.json，“ allowJs”屬性設(shè)置為 true。

為什么我需要一個(gè) jsconfig.json 文件

因?yàn)閂sCode的 JavaScript 支持可以在兩種不同的模式下運(yùn)行:

• Scope-no jsconfig.json: 文件在這種模式下，在 Visual Studio Code 中打開的 JavaScript 文件被視為獨(dú)立的單元。 只要文件 a.js 沒有顯式引用文件 b.ts (使用 import 或 CommonJS 模塊) ，這兩個(gè)文件之間就不存在通用的項(xiàng)目上下文。
• Explicit Project-with jsconfig.json: JavaScript 項(xiàng)目通過 jsconfig.json 文件定義。 目錄中出現(xiàn)這樣的文件表明該目錄是 JavaScript 項(xiàng)目的根目錄。 文件本身可以選擇列出屬于項(xiàng)目的文件、要從項(xiàng)目中排除的文件以及編譯器選項(xiàng)(見下文)。

當(dāng)工作區(qū)中有一個(gè) jsconfig.json 文件來定義項(xiàng)目上下文時(shí)，JavaScript 體驗(yàn)會(huì)得到改善。 出于這個(gè)原因，我們提示您在一個(gè)全新的工作區(qū)中打開一個(gè) JavaScript 文件時(shí)創(chuàng)建一個(gè) jsconfig.json 文件。

Location of jsconfig.json

我們通過創(chuàng)建一個(gè) jsconfig.json 文件來定義我們代碼的這一部分，我們網(wǎng)站的客戶端，作為一個(gè) JavaScript 項(xiàng)目。 將文件放在 JavaScript 代碼的根目錄下，如下所示。

在更復(fù)雜的項(xiàng)目中，您可能在工作區(qū)中定義了多個(gè) jsconfig.json 文件。 您希望這樣做，這樣一個(gè)項(xiàng)目中的代碼就不會(huì)被建議作為 IntelliSense 在另一個(gè)項(xiàng)目中進(jìn)行編碼。 下面是一個(gè)帶有客戶端和服務(wù)器文件夾的項(xiàng)目，展示了兩個(gè)獨(dú)立的 JavaScript 項(xiàng)目。

例子

默認(rèn)情況下，JavaScript 語(yǔ)言服務(wù)將為您的 JavaScript 項(xiàng)目中的所有文件分析并提供 IntelliSense。 為了提供正確的智能感知，您需要指定要排除或包含哪些文件。

使用 “exclude”

Exclude 屬性(glob 模式)告訴語(yǔ)言服務(wù)哪些文件不是源代碼的一部分。 這使性能保持在一個(gè)高水平。 如果 IntelliSense 速度慢，則向排除列表添加文件夾(如果檢測(cè)到速度慢，VS 代碼將提示您這樣做)。

{
 "compilerOptions": {
 "module": "commonjs",
 "target": "es6"
 },
 "exclude": ["node_modules"]
}

提示: 您希望排除由構(gòu)建過程生成的文件(例如，dist 目錄)。 這些文件將導(dǎo)致建議顯示兩次，并將減緩智能感知。

使用 “include”

或者，您可以使用 include 屬性(glob 模式)顯式地設(shè)置項(xiàng)目中的文件。 如果沒有 include 屬性，則默認(rèn)情況下包含包含目錄和子目錄中的所有文件。 如果指定了 include 屬性，則只包含這些文件。 下面是一個(gè)帶有明確 include 屬性的示例。

{
 "compilerOptions": {
 "module": "commonjs",
 "target": "es6"
 },
 "include": ["src/**/*"]
}

提示: exclude 和 include 中的文件路徑相對(duì)于 jsconfig.json 的位置

jsconfig Options 選項(xiàng)

下面是 jsconfig“ compilerOptions”來配置 JavaScript 語(yǔ)言支持。

compilerOptions

提示: 不要被 compilerOptions 搞糊涂了。 這個(gè)屬性之所以存在，是因?yàn)?jsconfig.json 是 tsconfig.json 的后代，后者用于編譯打字稿。