TypeScript类型自动推断：VSCode+CodeGeeX实操指南

在 VSCode 中编写 TypeScript 时，手动补全接口定义、类型断言或泛型参数会严重打断编码节奏。CodeGeeX 插件能根据光标位置分析上下文，实时生成与变量结构匹配的类型声明，大幅减少输入量。它的局限性在于：必须登录账户才能使用，且无法推断未导出的外部函数的返回类型。日常开发中，这依然是一把提升效率的利器。

先从安装入手。打开 VSCode 扩展市场（快捷键 Ctrl+Shift+X），搜索 CodeGeeX，点击安装，然后重启或点击“重新加载”激活插件。安装后右下角状态栏会出现 CodeGeeX 图标，表明模型已加载。如果图标未显示，通常是因为未登录——不登录则无法使用类型推断功能。

为变量声明自动补全类型注解

两种常用方式。第一种通过快捷键：光标置于变量名后（例如 const user = { name: 'Alice', age: 30 }; 中的 user 之后），按 Alt+K（Windows）或 Option+K（Mac），插件会在光标前插入类型注解：const user: { name: string; age: number } = { ... };。

第二种通过右键菜单：选中整行变量声明 → 右键 → “CodeGeeX: Infer Type for Selection”，插件会根据右侧表达式结构生成最简联合类型或内联对象类型。

注意：若右侧为函数调用（如 getData()），CodeGeeX 会尝试根据已有 JSDoc 注释或返回值进行推断，但对未导出或未声明的外部函数，它无能为力——此时建议为函数添加 @returns 注释，能显著提升准确率。

为函数参数和返回值批量添加类型

选中文档中完整的函数声明（包括函数名、参数列表和函数体），按 Ctrl+Shift+P 打开命令面板，输入 CodeGeeX: Add Type Annotations to Function 并回车。插件会自动识别参数数量、解构、可选参数、默认值，以及返回值中是否有 return 语句及其类型，最终生成包含完整类型签名的函数声明。

举例：原始函数 function formatName(obj) { return obj.first + ' ' + obj.last; } 会被重写为 function formatName(obj: { first: string; last: string }): string { ... }。该过程依赖 AST 解析，若函数体内有未使用的参数，插件仍会生成类型，但不会自动标记为 optional，因此生成后建议手动审查。

从 JSON 响应数据生成 interface

此功能在对接 API 时尤为实用。复制一段真实 JSON 数据（例如 {"id":1,"title":"Hello","completed":false}），在 TypeScript 文件中新建空 interface 声明，将光标置于花括号内，按 Alt+Shift+I。CodeGeeX 会立即生成 interface Todo { id: number; title: string; completed: boolean; }。

若 JSON 中包含 null 或混合类型（如 "price": null 或 "tags": ["a", 123]），插件默认使用 any 或联合类型（如 string | number）。生成后可手动替换为更精确的类型，比如将 tags: any[] 改为 tags: (string | number)[]。整体而言，该工具能省去大量手动定义接口的重复劳动。