codebuddy数据导入失败主因是源文件格式异常、路径含非法字符、权限不足或目标项目未激活；须检查json/csv结构合法性、清除bom头、确保utf-8编码、路径无中文/空格/特殊符号、用户有读写权限，并关闭auto-detect schema后重试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy数据导入失败时，界面常无明确报错，仅卡在“正在处理”或直接跳回空白状态，实际是因源文件格式异常、路径含非法字符、权限不足或目标项目未激活导致导入链路中断。
确认导入源文件合规性
第一步：用文本编辑器（如Notepad++或VS Code）打开待导入的JSON/CSV文件，检查首尾是否为合法结构——JSON必须以{或[开头、以}或]结尾；CSV必须每行字段数一致、无跨行引号断裂。
第二步：删除文件末尾可能存在的BOM头（尤其是Windows记事本保存的UTF-8文件），否则CodeBuddy解析器会将误判为非法字符并静默终止导入。
第三步：若文件来自Excel导出，务必选择“UTF-8 CSV”而非“Windows 1252”，后者会导致中文字段乱码→解析失败→无提示回退。
验证目标项目状态与路径权限
方法一：右键点击CodeBuddy左侧项目树中的目标文件夹 → 选择“Reveal in Explorer/Finder” → 确认该路径不包含中文、空格或特殊符号（如&、!、【】），【一旦含中文路径，导入必然失败且不报错】。
方法二：在终端执行ls -l "你的项目路径"（macOS/Linux）或icacls "你的项目路径"（Windows），确认当前用户对该目录有读写权限；若显示Permission denied，需手动赋予Full Control（Windows）或chmod 755（macOS/Linux）。
强制刷新导入上下文
第一步：关闭所有已打开的编辑器标签页，包括未保存的临时文件。
第二步：点击菜单栏项目 → 关闭项目，确保项目完全卸载。
第三步：重新通过文件 → 打开文件夹选择同一项目根目录（不是子目录），等待右下角状态栏出现“Project indexed”提示后再尝试导入。
第四步：导入前，在设置中搜索import，关闭Import > Auto-detect schema选项——该功能在字段类型推断错误时会阻塞整个流程，关掉后可手动指定映射规则。
