> ## Documentation Index
> Fetch the complete documentation index at: https://cat.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 文件提及

文件提及让你可以将工作区中的任何文件直接引入与 Cline 的对话中。不再需要复制和粘贴代码片段 - 只需输入 `@/` 并指向你需要帮助的文件。

当你在聊天中输入 `@/` 时，Cline 会显示你的工作区文件。浏览文件夹，选择你想要的文件，它会立即对 Cline 可用 - 包含所有导入、相关函数和周围上下文。

我在调试时经常使用文件提及。不再需要尝试确定要复制代码的哪些部分，我只需直接引用文件：

```
我的表单提交时出现这个错误：@terminal

这是我的组件：@/src/components/ContactForm.jsx

这是 API 端点：@/src/api/contact.js

我遗漏了什么？
```

这为 Cline 提供了所需的一切 - 错误消息、组件代码和 API 端点 - 而我无需复制任何内容。Cline 可以看到导入、依赖关系以及可能导致问题的所有周围上下文。

当你处理跨越多个文件的复杂错误时，文件提及功能会发光。以前，我必须仔细复制每个相关文件，确保不遗漏任何重要内容。现在我只需用 `@/` 引用每个文件，Cline 就能获得完整的图片。

下次遇到问题时，尝试使用文件提及而不是复制代码。你会节省时间并获得更好的答案，因为 Cline 拥有所需的所有上下文。

## 底层工作原理

当你在消息中使用文件提及时，这是背后发生的情况：

1. 当你发送消息时，Cline 检测文本中的 `@/path/to/file` 模式
2. 扩展程序解析相对于工作区根目录的文件路径
3. 它检查文件是二进制文件（如图像）还是基于文本的
4. 对于文本文件，它读取完整的文件内容
5. 文件内容以结构化格式附加到你的消息中：
   ```
   <file_content path="path/to/file">
   [完整文件内容]
   </file_content>
   ```
6. 这个增强的消息与嵌入的文件内容一起发送给 AI
7. AI 现在可以"看到"完整的文件内容，就像你复制粘贴过一样

每当你使用文件提及时，这个无缝过程都会自动发生，为 AI 提供完整上下文，而无需你手动复制任何内容。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.