使用过Qoder AI工具的用户可能都遇到过这样的困扰：明明只要求修改一个变量名，结果它却遍历了所有相关文件——不仅改了props，还顺带修改了父组件、测试文件甚至类型定义。这种“过度修改”在个人开发时还能接受，但在多人协作或灰度发布阶段，很容易引入不可控的变更风险。为了让AI精准遵循“只改这些，别动其他”的指令，以下三类路径约束方法可以帮助你有效控制。

通过 @file 显式指定目标文件

这是最直接且可靠的方法，适用于单次指令中只希望AI修改1～3个明确文件的场景。

在聊天输入框中，输入@符号后，直接键入文件路径，例如：@src/services/api.ts。支持多文件叠加，用空格分隔，如：@src/utils/date.ts @src/types/index.ts——AI将仅读取并修改这两个文件，其他代码完全不纳入推理上下文。

重要提示：路径必须是项目根目录下的相对路径，且文件必须真实存在。如果输入了@nonexistent.js，Qoder不会报错，但AI因为无法加载内容而可能生成无效代码——这个坑很多用户都踩过。

通过 .qoderignore 临时屏蔽其他文件

当你需要批量处理某类文件（例如只修改所有.test.tsx文件），又担心AI误触同目录下的非测试文件时，可以用此方法收窄搜索范围。

第一步：在项目根目录创建或编辑.qoderignore文件。

第二步：写入要排除的路径模式，例如：**/*.tsx !**/*.test.tsx——这表示“忽略所有.tsx文件，但保留.test.tsx”。感叹号!是白名单语法，Qoder原生支持。

第三步：保存后立即生效，无需重启。后续所有AI指令（包括/refactor、/fix）都将严格遵守此规则。

该配置只影响当前工作区，提交到Git后团队成员可以直接使用，无需每人手动添加@——可谓一劳永逸的解决方案。

在指令中嵌入路径约束条件

适用于高频、标准化的修改任务，例如“给所有API调用函数添加超时参数”，你希望避免每次手动输入，而是将其固化为一条可复用的指令。

方法一：创建自定义指令

打开Qoder设置 → 指令管理 → 添加新指令，命名为add-api-timeout。在Prompt正文中写明硬性限制：

## 角色
你是一个前端安全加固工程师
## 任务
仅修改src/api/目录下的.ts文件，为每个fetch或axios调用添加{ timeout: 10000 }选项
## 输出格式
只输出修改后的完整文件内容，不解释，不新增文件

方法二：运行时追加--path参数（仅限CLI使用）

在Qoder CLI终端中执行：qoder-cli refactor "add timeout" --path "src/api/**/*.ts"。该参数会强制AI仅扫描匹配glob模式的文件，即使上下文中有其他文件也不会被考虑——适合临时进行应急修复的场景。

总结而言：@file适合单次精准修改，.qoderignore适合批量排除，自定义指令或--path适合长期复用。三者可以组合使用，但请记住：路径约束越明确，AI的行为就越可控。不要指望它自行“理解”——你为它划定范围，它才不会越界。