必须手动激活TypeScript语言服务并配置tsconfig.json，否则Fitten Code无法识别interface、泛型、路径别名；需设置target、module、moduleResolution为ES2022/NodeNext，排除无关目录，启用路径别名与类型缓存。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在大型前端项目中启用 Fitten Code 的 TypeScript 支持后，类型推导延迟高、补全不准确、接口跳转失效等问题会直接拖慢多人协作开发节奏。必须通过精准的 tsconfig.json 配置与编辑器联动策略，让 Fitten Code 真正理解项目类型拓扑结构。
确认 Fitten Code 已加载 TypeScript 语言服务
打开任意 .ts 或 .tsx 文件 → 查看 VS Code 窗口右下角状态栏 → 确认显示“TypeScript”而非“JavaScript”或“Plain Text”。若未显示，点击该区域 → 选择“TypeScript” → 此时 Fitten Code 才开始基于 tsconfig.json 进行类型索引。
这一步不可跳过，【Fitten Code 不会主动触发 TypeScript 语言服务初始化，必须手动激活】。否则所有类型提示都基于 JavaScript 基础推断，无法识别 interface、泛型、路径别名等关键特性。
配置 tsconfig.json 启用深度类型索引
在项目根目录打开 tsconfig.json → 确保 compilerOptions 中包含以下三项：
立即学习“前端免费学习笔记（深入）”；
"target": "ES2022",
"module": "NodeNext",
"moduleResolution": "NodeNext"
这三者必须同时存在，【缺一不可】。ES2022 提供现代语法支持，NodeNext 模式才能正确解析 import { X } from '@utils' 这类路径别名，否则 Fitten Code 将无法定位 src/utils 下的真实类型定义文件。
删除 "lib" 字段中任何低于 "ES2022" 的条目（如 "ES2015"），避免类型库版本混杂导致推导冲突。
启用路径别名并同步到 Fitten Code
方法一：tsconfig.json 中配置 baseUrl 和 paths
"baseUrl": "./src",
"paths": {
"@/*": ["*"],
"@components/*": ["components/*"],
"@interfaces/*": ["interfaces/*"]
}
方法二：确保 node_modules/.fitten/config.json 存在且包含 "resolvePaths": true（Fitten Code v2.4+ 默认启用，但旧版需手动添加）。
⚠️ 注意：修改 tsconfig.json 后必须重启 VS Code 窗口，Fitten Code 才会重新扫描路径映射关系。仅重载窗口或刷新插件无效。
优化类型索引性能的三步操作
第一步：在 tsconfig.json 的 exclude 字段中显式排除无关目录：
"exclude": ["node_modules", "dist", "build", "coverage", "**/*.test.ts", "**/__mocks__/*"]
第二步：为大型接口定义目录（如 src/interfaces）单独设置 declaration: true，并在 include 中精确指定：
"include": ["src/**/*", "src/interfaces/**/*.d.ts"]
第三步：在 VS Code 设置中搜索 “fitten typescript cache”，勾选 “Enable Type Cache Persistence” → 这能让 Fitten Code 复用上一次的类型图谱，首次启动后类型补全响应时间可从 1200ms 降至 280ms 内。
