Qoder无法处理中文路径是因UTF-8路径未正确转义或系统调用适配失败，解决方法包括：一、改用英文路径并启用UTF-8-SIG编码；二、文件头声明编码并用标准库安全转换路径；三、配置CLI启动参数启用宽字符支持；四、通过JetBrains插件桥接层预处理路径。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 Qoder 时发现无法正确打开、读取或执行位于中文路径下的项目文件（如“D:我的项目main.py”或“/Users/张三/代码/test.go”），则很可能是 Qoder 内部路径解析模块未对 UTF-8 编码的路径字符串进行正确转义或系统调用适配，导致系统 API（如 open()、chdir()、QProcess::start()）接收非法字节序列而失败。以下是解决此问题的步骤：
一、修改项目根目录为纯英文路径并启用 UTF-8-SIG 全局编码
该方法通过规避中文路径本身来消除底层系统调用失败风险，同时确保所有文件以兼容性更强的 UTF-8-SIG 格式加载，避免因 BOM 缺失导致的解码中断。Qoder 在无 BOM 的 UTF-8 文件中可能误判首字符边界，进而影响路径字符串构造。
1、将当前项目整体移动至不含中文、空格及特殊符号的路径下，例如：C:devqoder_project 或 /home/user/qoder_proj；
2、在项目根目录创建或编辑 .qoder/config.yaml；
3、写入以下内容（严格使用两个空格缩进，禁止 Tab）：
language_encodings:
python: utf-8-sig
go: utf-8-sig
cpp: utf-8-sig
html: utf-8-sig
4、保存后，在 Qoder IDE 中执行 Ctrl+Shift+P → reload context；
5、打开任意源文件，确认右下角状态栏显示 UTF-8-SIG 而非仅 UTF-8。
二、在文件头添加编码声明并强制路径字符串 UTF-8 转义
该方法适用于必须保留在中文路径中开发的场景。通过显式声明文件编码，使 Qoder 在解析源码时准确还原中文路径字符串；再结合标准库函数对路径做 UTF-8 安全转义，确保传递给系统 API 的字节流符合 POSIX 或 Windows Wide API 要求。
1、打开目标入口文件（如 main.py 或 app.go）；
2、在第一行插入编码声明：Python 文件写 # -*- coding: utf-8 -*-，Go 文件在 package 声明前一行写 //go:encoding utf-8；
3、在代码中构造中文路径时，禁用原始字符串拼接，改用标准库安全转换：
Python 示例：
import os
from pathlib import Path
chinese_path = str(Path(r"D:我的项目").resolve())
os.chdir(chinese_path) # 自动处理 UTF-8 字节流
Go 示例：
import "os"
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
import "path/filepath"
chinesePath := filepath.Clean(`D:我的项目`)
os.Chdir(chinesePath)
三、配置 Qoder CLI 启动参数启用宽字符路径支持
该方法直接干预 Qoder 主进程启动环境，通过注入 Windows Wide API 兼容标志或 Linux 系统 locale 强制策略，使底层 Qt 框架和 C 运行时能正确识别多字节路径参数。适用于 Qt6 内核版本的 Qoder CN，其默认禁用宽字符路径解析以提升启动速度。
1、关闭所有 Qoder 实例；
2、Windows 用户：在命令提示符中执行：
set QT_QPA_PLATFORM_PLUGIN_PATH=
set PYTHONIOENCODING=utf-8
start "" "C:Program FilesQoder CNqoder-cn.exe" --platform windows:fontengine=freetype
3、macOS/Linux 用户：在终端中执行：
export LC_ALL=zh_CN.UTF-8
export QT_QPA_PLATFORM=offscreen
/Applications/Qoder CN.app/Contents/MacOS/qoder-cn --no-sandbox
4、启动后，新建终端会话，运行 pwd 验证当前路径是否完整显示中文；
5、尝试在资源管理器中右键“在 Qoder 中打开”，观察是否成功加载含中文路径的文件夹。
四、通过 JetBrains 插件桥接层注入路径预处理逻辑
该方法利用 Qoder CN 对 JetBrains IDE 的深度集成机制，在插件层拦截所有文件路径参数，于传递至 Qoder 核心前统一执行 UTF-8 Normalize 和 Windows UNC 路径转换，彻底绕过 Qt 原生路径解析缺陷。适用于使用 PyCharm 或 IntelliJ 作为主 IDE 并通过插件调用 Qoder 的用户。
1、打开 JetBrains IDE → Settings → Plugins；
2、搜索并安装 Qoder Path Normalizer 插件（v1.2.0+）；
3、重启 IDE 后进入 Settings → Languages & Frameworks → Qoder → Path Handling；
4、勾选 Enable Unicode path normalization for Windows；
5、在 Custom UNC prefix 输入框中填写：\\?\；
6、点击 Apply，然后在项目中右键任意中文路径下的 .py 文件 → Qoder: Analyze with Lingma，验证是否正常触发分析流程。
