vscode中的 jsconfig.json

一、vscode中的 jsconfig.json

1、问题源头：在webpack模板中，import路径中的@符号意味着什么？

2、目录中存在jsconfig.json文件表示该目录为JavaScript项目的根目录。jsconfig.json文件主要用于定义根文件以及提供JavaScript语言服务的特定功能选项。

3、说明：若项目不涉及JavaScript，则无需特别关注jsconfig.json文件。此文件源自tsconfig.json，是TypeScript的配置文件，设置为允许JavaScript（通过将“allowJs”属性设置为true）。

4、Visual Studio Code的JavaScript支持可运行在两种模式下：当工作空间内存在定义项目上下文的jsconfig.json文件时，JavaScript体验会得到显著改善。因此，当在新工作空间中打开JavaScript文件时，系统会提示创建jsconfig.json文件。

5、定义代码区域（如网站的客户端部分）为JavaScript项目时，需在JavaScript代码的根目录下创建jsconfig.json文件。例如：

6、在复杂项目中，可能需要在工作空间中定义多个jsconfig.json文件以避免混淆，如在客户端和服务器文件夹下的两个单独JavaScript项目。

7、默认情况下，JavaScript语言服务将分析并为JavaScript项目中的所有文件提供IntelliSense功能。但需明确指定需排除或包含的文件，以确保提供正确的IntelliSense。

8、通过设置exclude属性（采用glob模式），可告诉语言服务哪些文件不是源代码的一部分，这有助于保持性能。若发现IntelliSense速度变慢，可将文件夹添加至排除列表（VS代码在检测到速度减慢时会提示执行此操作）。

9、提示：排除构建过程生成的文件（如dist目录）是明智之举，避免建议显示两次并降低IntelliSense速度。

10、使用include属性（同样采用glob模式）可明确设置项目中的文件。若未指定include属性，系统默认包含目录及其子目录中的所有文件；若指定了include属性，则仅包含这些文件。例如：

11、提示：exclude和include中的文件路径需相对于jsconfig.json的位置。

12、jsconfig中的“compilerOptions”用于配置JavaScript语言支持。

13、提示：此属性的存在是因为jsconfig.json是tsconfig.json的后代，后者用于编译TypeScript。

14、noLib不包含默认库文件（lib.d.ts） string-target指定使用的默认库（lib.d.ts），值为“es3”、“es5”、“es6”、“es2015”、“es2016”、“es2017”、“es2018”、“esnext”

15、checkJs启用JavaScript文件的类型检查 boolean true experimentalDecorators提供ES装饰器的实验支持 string allowSyntheticDefaultImports允许默认导入没有默认导出的模块 boolean true baseUrl用于解析非相对模块名称的基目录 string paths指定相对于baseUrl选项计算的路径映射 object见demo

16、要使IntelliSense使用webpack别名，需使用glob模式指定paths键，例如对于别名'ClientApp'（或@）：

17、只要可能，应排除不属于项目源代码的JavaScript文件。

18、提示：若工作空间中无jsconfig.json文件，则默认排除node_modules文件夹。

19、node排除node_modules文件夹 webpack、webpack-dev-server排除内容文件夹，例如dist bower排除bower_components文件夹 ember排除tmp和temp文件夹 jspm排除jspm_packages文件夹

20、当JavaScript项目过大导致性能下降时，通常是由于像node_modules这样的库文件夹所致。若VS Code检测到项目过大，则会提示编辑排除列表。

21、提示：有时难以正确配置jsconfig.json文件，此时可运行“Reload JavaScript Project”命令以重新加载项目并获取更改。

22、使用TypeScript编译器进行低级编译

23、当使用tsc将ES6 JavaScript向下级编译为较旧版本时，jsconfig.json中的以下编译器选项适用：

24、module模块代码生成值为“commonjs”、“system”、“umd”、“amd”、“es6”、“es2015”

25、diagnostics显示诊断信息 boolean

26、emitBOM在输出文件的开头发出UTF-8字节顺序标记（BOM）

27、inlineSourceMap使用源映射发出单个文件，而不是使用单独的文件

28、inlineSources在单个文件中将源与源图一起发出；需设置--inlineSourceMap

29、jsx JSX代码生成：“保留”或“反应”？

30、reactNamespace指定在针对'react'JSX发出的目标时为createElement和__spread调用的对象

31、mapRoot将位置指定为字符串中的uri，其中调试器应找到映射文件而不是生成的位置

32、noEmitHelpers不在编译输出中生成自定义辅助函数，如__extends

33、noEmitOnError如果报告任何类型检查错误，不发起输出

34、noResolve不将三斜杠引用或模块导入目标解析为输入文件

35、outFile连接并将输出发送到单个文件

36、removeComments不向输出发出注释

37、rootDir指定输入文件的根目录。用于通过--outDir控制输出目录结构

38、sourceMap生成相应的'.map'文件

39、sourceRoot指定调试器应找到JavaScript文件而不是源位置的位置

40、stripInternal不为具有'@internal'注释的代码发出声明

41、emitDecoratorMetadata在源中为装饰声明发出设计类型元数据

42、noImplicitUseStrict不在模块输出中发出“use strict”指令

43、这个文档是否有所助益？参考：JavaScript语言服务 TypeScript tsconfig.json glob模式 webpack模板中import路径中@符号的含义

44、翻译：Xindot原文：code.visualstudio.com/d...

二、Flask-SocketIO 简单使用指南

Flask-SocketIO使Flask应用程序能实现客户端与服务器之间的低延迟双向通信，支持多种编程语言如JavaScript、C++、Java和Swift等的SocketIO官方客户端库连接。安装通过pip完成，兼容Python 2.7及Python 3.3以上版本。使用eventlet、gevent或Flask开发服务器作为异步服务，且进程间通过消息队列（如Redis、RabbitMQ等）协调操作。客户端使用Socket.IO官方JavaScript库连接服务器，非官方客户端也需遵循Socket.IO协议。

在Flask中整合Flask-SocketIO，只需编写以下代码示例实现简单的Web服务器：

安装Flask-SocketIO后，使用socketio.run()启动Socket.IO服务器，它封装了Web服务器的启动过程，提供调试模式下的Werkzeug服务器或生产模式下的eventlet或gevent服务器。在Flask 0.11中引入的命令行界面提供了适用于启动Socket.IO服务器的新命令。

处理连接和断开事件，注册相应处理程序。连接事件处理可选择返回False拒绝连接，进行客户端身份验证。连接与断开事件在每个命名空间上分别发送。

接收消息在客户端通过JavaScript回调实现，Flask-SocketIO中，服务器端需为事件注册处理程序。未命名事件使用字符串消息，JSON数据事件使用JSON格式。自定义事件支持多种数据类型，并允许多个参数。命名空间允许客户端在同一物理套接字上复用多个独立连接。

使用on_event方法处理自定义命名空间的事件，客户端请求确认回调，确认消息接收。处理函数返回值作为回调函数参数传递给客户端。

发送消息通过send()和emit()函数实现，无名事件使用send()，命名事件使用emit()。当使用命名空间时，send()和emit()默认使用传入消息的命名空间，可指定不同命名空间。发送多参数事件时，以元组形式传递。

SocketIO支持广播功能，通过send()和emit()的broadcast=True参数实现。在启用广播情况下，消息发送至所有连接的客户端，包括发件人。无命名空间则向全局名称空间客户端广播消息。

在服务器需要向客户端广播消息时，使用socketio.send()和socketio.emit()方法。注意，socketio.send()与socketio.emit()在功能上与send()与emit()不同，broadcast=True默认启用，无需指定。

客户端分组为房间的概念通过join_room()和leave_room()实现，允许用户接收来自特定房间的消息。send()和emit()接收room参数，将消息发送到所有在该房间的客户端。连接时客户端分配一个房间，可加入多个房间。无上下文的socketio.send()和socketio.emit()也接受room参数广播消息。

Flask-SocketIO的错误处理功能允许处理异常，错误处理函数接收异常对象作为参数。请求的消息和数据参数可通过request.event变量检查，适用于事件处理程序外部的错误记录和调试。

基于类的命名空间提供替代的事件处理方式，使用flask_socketio.Namespace作为基类创建命名空间。事件名称由方法名称前缀on_决定，方法名称应遵循合法字符规则。命名空间实例包含类中方法的版本，当未给出参数时，默认为正确的命名空间。

基于类的命名空间中定义的方法会根据事件名称调用，如果在命名空间类中未定义相应方法，则忽略事件。命名空间中定义的所有事件名称必须符合方法名称规则。事件在命名空间中具有处理程序时，不调用装饰器函数处理程序。

调试Flask-SocketIO应用时，通过JavaScript连接服务端进行测试。使用HTML文件在浏览器中访问服务端，测试更多功能。相关文档提供详细指导。