jsconfig.json 中文文档 |
您所在的位置：网站首页 › json库是干什么的 › jsconfig.json 中文文档 |
jsconfig.json 中文文档
|
英文原版文档地址 jsconfig.json 是什么？目录中存在jsconfig.json文件时，表明该目录是 JavaScript 项目的根目录。jsconfig.json文件指定了根文件以及 JavaScript 语言服务 提供的功能选项 Tip: 如果不使用 JavaScript，那么无需关心jsconfig.json Tip: jsconfig.json源于 TypeScript 的配置文件tsconfig.json。相当于tsconfig.json的allowJs属性设置为true 为什么需要 jsconfig.json 文件？Visual Studio Code 的JavaScript支持可以在两种不同的模式下运行： 文件范围 - 没有 jsconfig.json：在此模式下，在 Visual Studio Code 中打开的 JavaScript 文件被视为独立的单元。只要文件a.js没有明确引用文件b.ts(使用import或CommonJS modules)，那么两个文件之间就没有公共的项目上下文 显式项目 - 包含 jsconfig.json：JavaScript 项目是通过jsconfig.json文件定义的，目录中存在此文件表示该目录是 JavaScript 项目的根目录。文件本身可以选择列出属于项目的文件，要从项目中排除的文件以及编译器选项等（请参见下文） 当工作空间中有一个定义项目上下文的jsconfig.json文件时，JavaScript 体验会得到改善。因此，当在新的工作区中打开 JavaScript 文件时，我们提供了创建jsconfig.json文件的提示 jsconfig.json 的位置通过创建一个jsconfig.json文件，我们将代码的这一部分（网站的客户端）定义为 JavaScript 项目。如下所示，将文件放置在 JavaScript 代码的根目录下 在更复杂的项目中，工作空间中可能定义了多个jsconfig.json文件。这将需要执行此操作，以便 IntelliSense 不会把一个项目中的代码错误地提示给另一个项目中的代码。下面是一个带有client和server文件夹的项目，其中显示了两个单独的 JavaScript 项目 注： IntelliSense 译为智能感知，在 vscode 环境下意为智能代码提示，下文不再翻译 实例默认情况下，JavaScript 语言服务将分析并为你的 JavaScript 项目中的所有文件提供 IntelliSense，你需要指定要排除或包括的文件，以提供适当的 IntelliSense 使用 exclude 属性exclude属性（glob 模式）告诉语言服务哪些文件不属于源代码，这样可以使性能保持较高水平。如果 IntelliSense 速度较慢，则可尝试一些文件(夹)添加到exclude列表中（VS Code 如果检测到速度减慢将提示你执行此操作） { "compilerOptions": { "module": "commonjs", "target": "es6" }, "exclude": ["node_modules"] }Tip: 建议排除由构建过程生成的文件（例如dist目录），否则这些文件将导致建议显示两次，并且会降低 IntelliSense 的速度 使用 include 属性另外，可以使用 include 属性（全局模式）在项目中显式设置文件。如果不存在include属性，则默认为包含目录和子目录中的所有文件。当指定include属性时，仅包括指定的那些文件。下面是一个带有显式include属性的示例 { "compilerOptions": { "module": "commonjs", "target": "es6" }, "include": ["src/**/*"] }Tip: exclude 和 include 中的文件路径是相对于 jsconfig.json 位置的 jsconfig Options以下是用于配置 JavaScript 语言支持的jsconfig的compilerOptions Tip: 不要被 compilerOptions 所迷惑。该属性存在是因为 jsconfig.json 源自 tsconfig.json，后者用于编译 TypeScript 选项描述noLib不包括默认库文件 lib.d.tstarget指定要使用的默认库 lib.d.ts，可选 es3 / es5 / es6 / es2015 / es2016 / es2017 / es2018 / es2019 / es2020 / esnextmodule指定模块系统（生成模块代码时），可选 amd / commonJS / es2015 / es6 / esnext / none / system / umdmoduleResolution指定如何解析模块以进行导入，可选 node / classiccheckJs对 JavaScript 文件启用类型检查experimentalDecorators为ES装饰器提案提供实验支持allowSyntheticDefaultImports允许从模块进行默认导入而没有默认导出。这不影响代码生成，仅影响类型检查baseUrl基本目录，用于解析非相对模块名称paths指定要相对于 baseUrl 选项计算的路径映射可在 TypeScript 编译选项文档 中阅读有关可用的compilerOptions的更多信息 使用 Webpack 别名为了使 IntelliSense 使用 Webpack 别名，需要使用全局模式指定paths 例如，对于别名 ClientApp { "compilerOptions": { "baseUrl": ".", "paths": { "ClientApp/*": ["./ClientApp/*"] } } }然后使用别名 import Something from 'ClientApp/foo' 最佳实践尽可能排除包含 JavaScript 代码但又不属于项目源代码的文件(夹) Tip: 如果工作空间中没有jsconfig.json，则 VS Code 默认情况下将排除node_modules文件夹 下表是 常见项目组件 到其 安装文件夹的表，建议将其排除在外： 组件要排除的文件夹node排除node_modules 文件夹webpack, webpack-dev-server排除生成内容文件夹, 例如distbower排除bower_components文件夹ember排除tmp andtemp文件夹jspm排除jspm_packages文件夹当 JavaScript 项目变得太大而性能降低时，通常是由于库文件夹（如node_modules）所致。如果 VS Code 检测到项目过大，将提示你编辑exclude列表 |
【本文地址】
今日新闻 |
推荐新闻 |