VSCode智能提示：配置TypeScript与JavaScript的类型检查

启用 js 类型检查并配置 jsconfig.json和 JSDoc，可在 javaScript 中实现智能提示与错误检测；typescript 项目应开启 strict 模式优化类型安全，结合 vscode 设置与 ESLint 提升开发体验。

VSCode 对 TypeScript 和 javascript 的类型检查支持非常强大，合理配置可以显著提升开发效率和代码质量。你无需完全迁移到 TypeScript，就能在纯 JavaScript 项目中享受智能提示和类型检查的便利。

启用 JavaScript 的类型检查

VSCode 内置了对 JavaScript 文件的类型检查能力，基于 TypeScript 引擎实现。要开启此功能：

• 在项目根目录创建或修改 jsconfig.json 文件
• 设置 “checkJs”: true，即可对 .js 文件进行类型检查
• 可添加 “allowJs”: true 支持混合使用 JS 与 TS 文件

示例 jsconfig.json：

{"compilerOptions": {     "target": "es2017",     "checkJs": true,     "allowJs": true,     "jsx": "react"   },   "include": ["src/**/*"] }

开启后，VSCode 会在编辑器中用波浪线标出潜在类型错误，比如调用不存在的方法或传参类型不匹配。

立即学习“Java 免费学习笔记（深入）”；

利用 JSDoc 添加类型信息

在 JavaScript 中使用 JSDoc 注解，能大幅提升智能提示的准确度。

• 用 @type 标注 变量类型
• 用 @param 和 @returns 描述函数参数与返回值
• 支持 泛型 、类、 接口 等高级类型语法

例如：

提客 AI 提词器

「直播、录课」智能 AI 提词，搭配抖音直播伴侣、腾讯会议、钉钉、飞书、录课等软件等任意软件。

64

查看详情

/**  * @param {string} name  * @param {number} age  * @returns {boolean}  */ function isValidUser(name, age) {return name.length > 0 && age > 18;}

这样即使在 .js 文件中，VSCode 也能提供精确的参数提示和错误检测。

TypeScript 项目的配置优化

对于 .ts 项目，通过 tsconfig.json 可精细控制类型检查行为。

• 开启 “strict”: true 启用 严格模式（推荐）
• 使用 “noImplicitAny”: true 防止隐式 any 类型
• 启用 “strictNULLChecks” 避免 null/undefined 导致的运行时错误
• 配合 “exactOptionalPropertyTypes” 精确处理可选属性

这些设置能让类型系统更严谨，减少潜在 bug。VSCode 会实时反映这些规则的检查结果。

编辑器级别的提示增强

除了项目配置，还可调整 VSCode 设置以优化体验：

• 在设置中搜索“typescript.suggestionActions.enabled”，确保建议修复启用
• 打开“editor.quickSuggestions”确保触发智能提示
• 使用 Ctrl+. 快捷键查看快速修复建议（如生成接口、添加类型断言）
• 鼠标悬停在变量上查看推断出的类型

结合 ESLint 和 Prettier 可进一步统一代码风格与静态检查规则。

基本上就这些。合理配置后，无论是 TypeScript 还是 JavaScript，VSCode 都能提供接近 ide 级别的智能提示和类型安全保障。关键是根据项目实际情况选择合适的检查强度。