什么是 @Files 命令？
在 Chat 和 Cmd K 等 AI 输入框中，你可以使用 @Files 命令引用整个文件内容。此外，如果你在输入 @ 后继续输入，你将在 @Code 策略之后看到文件搜索结果。
为了确保你引用的是正确的文件，Cursor 会显示文件路径的预览。这在你有多个同名但位于不同文件夹中的文件时特别有用。
使用 @Files 命令时的文件路径预览
聊天中的长文件引用
在 Cursor 的聊天功能中，如果文件内容太长，Cursor 会将文件分成更小的块，并根据与查询的相关性对它们进行重新排序。这确保了 AI 能够优先处理最相关的文件部分。
长文件会被分块并按相关性排序
拖放功能
你可以从主侧边栏将文件拖放到 Composer、Chat 或 Cmd K 中，以将它们添加为上下文。这提供了一种快速引用文件的直观方式，无需手动输入 @Files 命令和文件路径。
提示
当处理大型代码库时，拖放功能特别有用，因为它消除了记忆或输入复杂文件路径的需要。
基本用法
1. 在聊天中引用文件
在聊天输入框中输入：
@Files src/components/Button.tsxCursor 会显示文件路径预览，确认这是你想要引用的文件。
2. 在 Cmd K 中引用文件
在 Cmd K 提示框中也可以使用相同的语法：
@Files src/config/settings.js3. 使用拖放功能
从主侧边栏直接拖动文件到聊天输入框或 Cmd K 提示框。
常见使用场景
@Files 命令在以下场景中特别有用：
1. 代码解释
请求 AI 解释一个文件中的代码是如何工作的。
请求："请解释这个组件的工作原理：@Files src/components/DataGrid.tsx"
2. 文档生成
要求 AI 为文件生成文档或注释。
请求："为这个工具函数生成详细的JSDoc注释：@Files src/utils/helpers.js"
3. 代码审查
请求 AI 审查文件中的代码质量和潜在问题。
请求："审查这个文件中的代码质量并提出改进建议：@Files src/services/api.ts"
最佳实践
-
明确你的问题
引用文件时，清楚地说明你想要 AI 关注文件的哪些方面，这样可以获得更有针对性的回答。
-
对于大文件使用更具体的引用
虽然 Cursor 会自动处理长文件，但如果你知道关注的是文件中的特定部分，可以考虑使用 @Code 命令引用特定代码段。
-
结合使用上下文命令
结合使用 @Files、@Folders 和其他上下文命令，可以为 AI 提供更全面的项目视图。
总结
@Files 命令是与 Cursor AI 交互的强大工具，它允许你：
- 轻松引用文件内容
- 确保引用了正确的文件
- 处理大型文件
- 使用拖放功能快速添加文件上下文
通过熟练使用这些功能，你可以更有效地与 Cursor 的 AI 能力交互，提高编程效率。