必须启用多文件上下文感知并手动添加3～5个核心文件，再用含动词+目标+组件名的注释触发补全，否则ai无法识别useuserquery等自定义hook导致类型错误或路径错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Cursor中开发React项目时，需要让AI一次性理解多个文件的上下文才能准确补全跨组件、跨状态的代码，否则补全结果常出现props类型不匹配、hook调用位置错误或状态更新逻辑断裂等问题。
启用多文件上下文感知
打开Cursor设置 → Editor → Context → 勾选“Enable multi-file context”。
这一步必须开启，否则Cursor默认只读取当前编辑文件的代码，【补全时完全看不到store.ts或utils/hooks.ts里的自定义hook定义】，强行补全会导致useAuth()被误写成useAuthHook()这类不存在的调用。
手动添加关键文件到上下文
方法一：在编辑器右上角点击「+ Add file」图标 → 从项目树中选择src/store/index.ts、src/utils/apiClient.ts、src/types/index.ts。
方法二：光标聚焦在待补全的代码行 → 按Ctrl+K（Windows）或Cmd+K（Mac）→ 输入“@” → 在弹出面板中搜索并勾选相关文件名。
注意：不要一次性添加超过12个文件，否则AI会因token超限而忽略部分文件内容，优先选与当前组件强耦合的3～5个核心文件即可。
编写提示词触发精准补全
第一步：在JSX return语句上方空行处输入注释：// @cursor: add loading state and error boundary for UserProfileCard
第二步：按Cmd+L（Mac）或Ctrl+L（Windows）激活补全命令。
第三步：Cursor会自动检索已加载的上下文文件，识别UserProfileCard组件依赖的useUserQuery hook定义位置，并生成带suspense fallback和errorElement的完整代码块。
这一步的关键是注释里必须包含动词（add/update/refactor）+ 具体目标（loading state）+ 组件名（UserProfileCard），缺一不可；若只写“优化这个组件”，AI无法判断该补全state还是refactor useEffect逻辑。
验证补全结果是否引用了正确文件
检查生成的代码中是否出现类似import { useUserQuery } from '@/store'的路径。
如果路径显示为import { useUserQuery } from '../store'或直接报错“Cannot find module”，说明上下文未成功加载src/store/index.ts——此时需关闭当前tab，重新用方法二手动@一次该文件再试。
