CodeBuddy在Kotlin项目中功能异常的根本原因是.kt文件未正确绑定Kotlin语言服务。需依次检查并启用Kotlin插件、确保使用build.gradle.kts、手动将.kt文件类型设为Kotlin、移除Plain Text中的*.kt关联、标记kotlin目录为Sources Root，并验证状态栏显示“Kotlin | JDK x”。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy在Kotlin项目中无法识别.kt文件、补全失效或右键菜单不出现AI操作项，通常是因为IDE未将Kotlin文件类型正确映射到Kotlin语言服务，导致插件无法加载上下文解析器。这一步必须在项目打开后、任何代码编辑前完成，否则后续所有补全和解释功能都将降级为纯文本匹配。
确认Kotlin语言服务已激活
进入File → Settings → Languages & Frameworks → Kotlin（macOS路径：Android Studio → Preferences → Languages & Frameworks → Kotlin），检查右侧是否显示“Kotlin is enabled for this project”。若显示灰色“Not configured”或空白状态，说明Kotlin插件未被项目识别。
点击右下角“Configure Kotlin”，选择当前模块→OK。该操作会自动在模块级build.gradle.kts中插入kotlin("jvm")插件声明，并同步Gradle依赖。
【若项目使用Groovy DSL（build.gradle），此步骤将失败】：CodeBuddy的Kotlin语言服务仅支持Kotlin DSL（build.gradle.kts）。必须先将build.gradle重命名为build.gradle.kts，并按Kotlin语法重写全部内容，否则Configure按钮不可点击且无响应。
强制重建文件类型关联
Android Studio默认通过文件扩展名.kt绑定Kotlin语言类型，但某些导入项目或手动创建的.kt文件可能被错误标记为“Plain Text”。需手动修正：
第一步：右键任意.kt文件 → “Override File Type” → 选择“Kotlin”。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
第二步：进入Settings → Editor → File Types，找到“Kotlin”类型，在“Registered Patterns”列表底部点击+号，输入*.kt（注意不是*.kts）。
第三步：在同一个“File Types”页面，向下滚动找到“Plain Text”，检查其“Registered Patterns”中是否误含*.kt——如有，选中并点击-号删除。这一步漏掉会导致新创建的.kt文件仍被当作纯文本处理，CodeBuddy完全不触发。
验证.kt文件是否真正归属Kotlin语言上下文
方法一：在任意.kt文件中输入val a =，然后按Ctrl+Space（Windows/Linux）或Cmd+Space（macOS）调出补全。若弹出kotlin.String、kotlin.Int等标准库类型，说明文件已正确绑定Kotlin语言服务；若只显示变量名历史或无响应，则绑定失败。
方法二：打开Project工具窗口 → 切换至“Project”视图（非Android视图）→ 展开src/main/kotlin → 右键该目录 → “Mark as” → 确认已标记为“Sources Root”。未标记会导致CodeBuddy无法索引该路径下的.kt文件，即使文件类型正确也无补全。
方法三：在.kt文件顶部输入package com.example，保存后观察左下角状态栏是否显示“Kotlin | JDK 17”字样。若显示“Plain Text”或空白，说明文件未被Kotlin PSI解析器接管，此时CodeBuddy的语义补全、函数签名提示、DSL链式调用等全部功能均不可用。
