Qoder多语言编码乱码问题可通过四步解决：一、在.config.yaml中配置language_encodings映射；二、文件头添加编码声明注释实现单文件覆盖；三、用qodercli encode命令批量重编码；四、通过JetBrains插件启用per-file编码覆盖。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 Qoder 进行多语言混合开发时，发现中文注释显示为方框、日文字符串变成问号、Python 文件因 GBK 保存导致 import 报错，或 Go 源码中韩文字符解析异常，则很可能是项目内文件编码格式未被 Qoder 正确识别或统一应用。以下是解决此问题的步骤：
一、在项目根目录 .qoder/config.yaml 中配置 language-encoding 映射
该方法通过项目级声明实现按文件后缀自动绑定默认编码，优先级高于 IDE 全局设置，可确保新建与编辑时均按规则解码与写入，避免跨语言文件混编时的编码冲突。
1、在项目根目录下创建隐藏文件夹 .qoder，并在其中新建或编辑 config.yaml；
2、在文件中写入标准 YAML 格式内容，注意缩进必须为两个空格，禁止使用 Tab：
3、language_encodings:
python: utf-8-sig
java: utf-8
cpp: gbk
go: utf-8
html: gb2312
js: utf-8
4、保存后，在 Qoder IDE 中执行快捷键 Ctrl+Shift+P，输入并选择 reload context；
5、分别打开 .py 与 .cpp 文件，确认右下角状态栏显示对应编码标识：UTF-8-SIG 与 GBK。
二、在文件头添加标准化编码声明注释（单文件强制覆盖）
当某文件需脱离项目级配置独立处理（如遗留 GBK Java 文件、UTF-8-BOM 的 Qt UI 文件），可通过首行注释显式指定编码，Qoder 加载时将优先识别该声明并覆盖 config.yaml 中的语言设定，实现细粒度控制。
1、打开目标文件（例如 src/legacy/Config.java）；
2、在文件最顶部第一行插入注释：// -*- coding: gbk -*-（适用于 Java/JS/TS）；
3、对 Python 文件，使用 PEP 263 标准格式：# -*- coding: utf-8 -*-；
4、对 Go 文件，在 package 声明前一行添加：//go:encoding utf-8；
5、保存后关闭再重新打开该文件，检查状态栏编码是否已切换为声明值。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
三、使用 qodercli encode 命令批量重编码历史文件
针对从 SVN/Git-LFS 导出的旧项目，若存在 UTF-8、GBK、BIG5 多种编码混存且数量庞大，手动修改不可行，此时 CLI 工具可基于内容特征自动探测原始编码，并批量转换为目标编码，保留文件结构与 Git 历史完整性。
1、在终端进入项目根目录，确保已安装 qodercli 并完成登录；
2、执行命令：qodercli encode --from auto --to utf-8 --ext .java,.cpp,.py；
3、工具将扫描匹配扩展名的所有文件，对每份文件进行编码置信度分析；
4、对检测置信度 ≥ 90% 的文件执行无损转码，低于阈值的文件将被记录至 encode_report.log；
5、运行完成后，使用 git status 确认仅编码变更被标记，无内容误改。
四、启用 JetBrains 插件的 per-file 编码覆盖功能
当在 JetBrains IDE（如 PyCharm、CLion）中使用 Qoder CN 插件时，插件提供独立于 IDE 自身编码设置的 per-file 覆盖机制，可绕过 IDE 的全局“Default Encoding”限制，专用于 Qoder 智能体上下文理解阶段的精准解码。
1、确保已安装 Qoder CN v2.4.0+ 插件并登录阿里云账号；
2、在 JetBrains 设置中进入 Settings → Editor → File Encodings；
3、勾选 Enable per-file encoding override for Qoder context parsing；
4、右键点击任意文件 → Qoder → Override Encoding for This File；
5、从弹出菜单中选择实际编码（如 GBK），该设置仅影响 Qoder 智能体读取该文件时的文本解析，不影响 IDE 编辑与编译行为。
