jsconfig是什么?
按照VSCode官网上的说法:
目录中存在jsconfig.json文件表示该目录是JavaScript项目的根目录。jsconfig.json文件指定根文件和JavaScript语言服务提供的功能选项。
同时做出了两点提示:
提示:如果您不使用JavaScript,则无需担心jsconfig.json。
提示:jsconfig.json源于tsconfig.json,是TypeScript的配置文件。jsconfig.json相当于tsconfig.json的“allowJs”属性设置为true。
从以上可以看出jsconfig.json文件是为了指明当前所在的是一个JavaScript项目,同时为这个项目声明一些特性,比如这个项目包括哪些文件,不包括那些文件,要不要使用类库文件,使用的模块系统等等。
同时它和tsconfig.json是一样的功效,不需要同时拥有他们两个。(可以理解为tsconfig是jsconfig的超集,就和ts与js的关系一样。)
jsconfig和d.ts对比
实际上我认为jsconfig和d.ts并不是同一纬度的东西。
1. 功能不同
jsconfig是声明VSCode如何处理一个项目,而d.ts则仅为js代码声明了对应的类型。
虽然jsconfig同样进行了相应的配置之后,我们也可以得到代码提示。但是实际上这里的提示只是因为其通知VSCode也要将对应的库纳入其扫描的范围内。实际上库上的js对象并没有被添加类型。
2. 对象不同
jsconfig配置的对象是当前所在的项目,也只为当前所在的项目提供了代码提示。而d.ts提供类型的对象不仅可以对当前项目生效,同时也会对使用当前库的项目起作用。
总的来说
总的来说,jsconfig和d.ts并不是同一维度的东西,
jsconfig当中默认是去除node_modules文件夹的,当我们主动将这个文件夹包含在我们的项目当中VSCode会把这个文件夹也放入我们的扫描动作当中去,因此我们可以获得引用一个npm库与引用一个自己写的文件一样的体验。而对于d.ts,在你引用一个库时,发现有d.ts文件会自动将他的信息扫描进来。
如果仅对比jsconfig提供的代码提示(实际上就是VSCode提供的代码提示)和d.ts提供的话:
-
jsconfig的更加便捷,只需要编写一个配置文件。
-
d.ts的更标准,它会作用于大部分编辑器而jsconfig目前只有VSCode支持。
-
扩展性更强,受制于VSCode的IntelliSense解析功能,如果没有支持用户也无法去修改。而d.ts是可以自主修改的。
几个问题
- 能配置自动跳转到源代码而不是编译后代码的方法嘛?
暂时没有找到相关的配置。同时我们可以猜想,怎么建立源代码到编译后代码的联系?答案是source map,但是目前编辑器还没有对source map产生支持。因此应该是无法实现的。同时,jsconfig的代码提示和d.ts的代码提示原理是一致的,而现在我们用到过的库都没能提供这种直接跳转源代码的能力。这也是无法实现的一个佐证。
- 现在jsconfig配置的效果和使用js2dt生成的d.ts是一样的,我们还需要去写d.ts嘛?
我认为是需要的。jsconfig配置之后需要达到非常好的效果是需要在源码上写jsdoc的(js2dt生成也是),而对于生成的d.ts你只需要对d.ts文件做一些修改就好了,这是非侵入性的更改。
网友评论