通义灵码需依赖本地项目索引准确引用文件，索引未完成前跨文件引用不可靠；保存文件触发增量更新；提示中须显式声明路径、导出方式和类型定义；可用#folder或拖拽限定上下文；通过跳转、路径校验和构建验证引用有效性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
通义灵码写代码时要准确引用项目内已有文件（比如 import utils/validate.js 或 from models.user import User），必须让AI感知到目标文件的真实路径、导出方式和类型定义，否则生成的引用会拼错路径、用错语法或指向不存在的模块。
确保跨文件索引已就绪
通义灵码不是靠猜路径，而是依赖本地构建的项目索引。首次打开项目后，IDE右下角状态栏会显示“Indexing…”并持续数秒至数分钟（取决于项目大小）。【未完成索引前，所有跨文件引用都不可靠】
编辑完一个文件后，务必按 Ctrl+S 保存——这会触发增量索引更新。如果刚给 User 类加了 new_field 属性，但没保存就切到 Controller 文件里让灵码补全，它仍会按旧结构推理，导致引用字段报错。
在自然语言提示中显式声明引用意图
不要只说“校验用户名”，而要明确写出“调用 src/utils/validator.ts 中的 isValidUsername 函数”。路径必须与项目实际目录结构完全一致，区分大小写，且不能省略扩展名（.ts/.js/.py 等）。
若目标文件导出方式特殊，需一并说明：例如“使用 export default 的 src/lib/apiClient.ts”或“从 src/types/index.d.ts 中解构导入 ResponseError 接口”。
利用 #folder 上下文锚定模块范围
方法一：快捷键输入
在通义灵码对话框中，直接输入 #folder（VS Code）或 @folder（IDEA），从弹出列表中选择 src/utils → 灵码后续所有生成都将优先从该目录下查找可用模块。
方法二：拖拽添加（仅 JetBrains IDE 支持）
在 Project 面板中，将 src/services 文件夹直接拖进对话输入框 → 立即建立服务层上下文，生成代码时自动识别其中的 OrderService、PaymentClient 等类名和导入路径。
【拖拽或 #folder 添加后，AI 不再随机猜测路径，而是严格限定在所选目录及其子目录内检索】
验证引用是否生效的三步操作
第一步：生成代码后，将光标停在新写的 import 行上 → 按 Ctrl+Click（Windows/Linux）或 Cmd+Click（Mac）尝试跳转。
第二步：若跳转失败，检查路径是否含多余 ../ 或遗漏 /，尤其注意 Webpack 别名（如 @/api）需在 .lingmarc 或 IDE 设置中提前声明。
第三步：在终端执行 npm run build 或 python -m py_compile，确认无 ModuleNotFoundError 或 ImportError 报错。
