CodeGeeX为JS项目引入类型安全需五步：一、初始化tsconfig.json并启用allowJs/checkJs；二、用JSDoc添加类型注解；三、安装@types包或自定义类型声明；四、配置CodeGeeX使用TS语言服务并加@ts-check；五、渐进迁移关键模块为.ts文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在使用CodeGeeX为现有JavaScript项目引入类型安全支持，则可能是由于项目缺乏静态类型检查导致运行时错误频发、接口变更难以追踪或协作开发效率下降。以下是将TypeScript类型系统集成到JS项目中的具体操作路径：
一、初始化TypeScript配置
在项目根目录中创建tsconfig.json文件，用于定义TypeScript编译行为与类型检查规则，使CodeGeeX能识别并应用类型上下文。
1、在终端中进入项目根目录，执行命令：npx tsc --init。
2、打开生成的tsconfig.json，将"allowJs"设为true，启用对.js文件的类型检查。
3、将"checkJs"设为true，确保JavaScript文件中的JSDoc注释可被解析为类型信息。
4、添加"types"字段，包含["node", "jest"]等运行时依赖类型声明（按实际依赖补充）。
二、通过JSDoc注入类型声明
利用JSDoc语法为JavaScript变量、函数和模块添加类型提示，无需重写代码即可让CodeGeeX推导出准确类型。
1、在函数上方添加@param和@returns标签，例如：/** @param {string} name @returns {number} */。
2、为对象字面量添加@type注解，例如：/** @type {{id: number, title: string}} */ const post = {...};
3、为导入模块指定类型，例如：/** @type {import('axios').AxiosInstance} */ const http = require('axios');
4、在类成员前使用@property标注属性类型，例如：/** @property {Date} createdAt */ this.createdAt = new Date();
三、安装并配置类型定义包
为第三方库补充缺失的类型定义，使CodeGeeX在补全和校验时能获取完整接口契约。
1、执行命令安装对应库的类型包：npm install --save-dev @types/react @types/react-dom（以React为例）。
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本，对Inline Chat功能进行了重大优化，包括UI设计升级、支持流式输出以提升响应速度，并新增“查看思路”按钮以便理解代码原理。同时，该版本在编辑器中新增CodeLens控件，支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
2、确认node_modules/@types中存在对应包，且其index.d.ts文件可被tsconfig.json自动包含。
3、若某库无官方类型定义，创建types/my-lib/index.d.ts，用declare module 'my-lib'声明任意类型。
4、在tsconfig.json的"typeRoots"中加入["types", "node_modules/@types"]，扩展类型搜索路径。
四、启用CodeGeeX的TS感知模式
调整CodeGeeX插件设置，使其基于TypeScript语言服务进行智能补全与错误提示，而非仅依赖JavaScript基础语法。
1、在VS Code中打开设置，搜索CodeGeeX: Language Server，将其值设为TypeScript。
2、关闭并重新打开JS文件，观察状态栏是否显示TS标识而非JS。
3、在JS文件顶部添加// @ts-check指令，强制启用当前文件的类型检查。
4、若出现类型错误提示，右键点击问题行，选择CodeGeeX: Ignore this line临时抑制误报（仅限调试阶段）。
五、渐进式迁移关键模块为.ts文件
将核心逻辑模块逐步转为TypeScript源码，获得更严格的类型约束与重构支持，同时保持与原有JS代码的兼容性。
1、将src/utils.js重命名为src/utils.ts，保留原内容不变。
2、在文件顶部添加export {}语句，避免“未使用声明”错误。
3、将require调用替换为import语法，并为导入项添加类型断言，例如：import { fetchData } from './api.js';。
4、运行npx tsc --noEmit验证迁移后无类型错误，再提交更改。
