Cursor - 符号

在 Cursor 中使用 @ 符号在聊天中引用代码、文件、文档和其他上下文的指南，直接更具体的指定上下文环境！

@-symbols-basics

以下是所有可用 @ 符号的列表：

@Files- 引用项目中的特定文件
@Folders - 引用整个文件夹以获得更广泛的上下文
@Code - 引用代码库中的特定代码片段或符号
@Docs- 访问文档和指南
@Git- 访问 git 历史记录和更改
@Past Chats- 使用汇总的 Composer 会话
@Cursor Rules-使用光标规则
@Web- 参考外部 Web 资源和文档
@Lint Errors- 引用 lint 错误（仅限Chat）

@Files使用和测试

准备测试文件 main.js

/**
 * 用户登录方法
 * @param {Object} params - 登录参数
 * @param {string} params.username - 用户名
 * @param {string} params.password - 密码
 * @returns {Promise} 登录结果
 */
const zwf_login = async (params) => {
  try {
    const response = await request.post('/api/login', params);
    return response.data;
  } catch (error) {
    console.error('登录失败:', error);
    throw error;
  }
};

/**
 * 用户注册方法
 * @param {Object} params - 注册参数
 * @param {string} params.username - 用户名
 * @param {string} params.password - 密码
 * @param {string} params.email - 邮箱
 * @returns {Promise} 注册结果
 */
const zwf_register = async (params) => {
  try {
    const response = await request.post('/api/register', params);
    return response.data;
  } catch (error) {
    console.error('注册失败:', error);
    throw error;
  }
};

测试@File对话

帮我总结下 @main.js 中包含哪些方法？

查看对话结果

@Code使用和测试

准备测试文件 main.js

/**
 * 用户登录方法
 * @param {Object} params - 登录参数
 * @param {string} params.username - 用户名
 * @param {string} params.password - 密码
 * @returns {Promise} 登录结果
 */
const zwf_login = async (params) => {
  try {
    const response = await request.post('/api/login', params);
    return response.data;
  } catch (error) {
    console.error('登录失败:', error);
    throw error;
  }
};

/**
 * 用户注册方法
 * @param {Object} params - 注册参数
 * @param {string} params.username - 用户名
 * @param {string} params.password - 密码
 * @param {string} params.email - 邮箱
 * @returns {Promise} 注册结果
 */
const zwf_register = async (params) => {
  try {
    const response = await request.post('/api/register', params);
    return response.data;
  } catch (error) {
    console.error('注册失败:', error);
    throw error;
  }
};

测试@Code 对话

帮我逐行解释下 @zwf_register 代码的含义！并且最终在源文件中添加注释！

查看对话结果

@Docs使用和测试

@Docs作用说明
@Docs 将 Cursor 连接到来自常用工具和框架的官方文档。当需要以下内容的最新权威信息时，请使用它：
- API 参考：函数签名、参数、返回类型
- 入门指南：设置、配置、基本用法
- 最佳做法：源中的推荐模式
- 特定于框架的调试：官方故障排除指南
@Docs对应文档配置
可以通过 cursor settings > features > Docs(cursor近期更新频繁，配置页面会有调整)来进行文档索引配置。粘贴所需文档的 URL 后，将显示以下模式：
地址： https://baomidou.com/introduce/ （mybatis-plus的官网测试）
- name：一般用于标识文档的名称、简称或唯一识别名，方便在系统里区分不同文档配置。比如这里填MyBatis - plus，就是用框架名称作为文档标识，后续可通过这个name快速找到、关联对应的文档配置。
- prefix：常指文档 URL 的前缀部分，可用于拼接完整文档路径，或作为统一的基础地址标识。像填的https://baomidou.com ，可能是该框架文档介绍板块的基础前缀，后续若要拼接具体文档子页面路径（如某个功能详细说明路径），可以基于这个prefix去扩展，让文档地址管理更规整。
- entrypoint：一般是文档的入口地址，即用户访问该文档时最先进入的页面。这里和prefix填了一样的地址，说明https://baomidou.com/introduce/ 就是MyBatis - plus文档的起始访问页面，用户通过这个entrypoint能直接进入到对应文档内容开始浏览。

测试@Docs对话

基于 @MyBatis-plus 查询下乐观锁插件如何使用

查看对话结果

@Web使用和测试

@Web作用说明
@Web 在实时 Internet 上搜索当前信息、博客文章和社区讨论。当您需要时使用它：
- 最近的教程：社区生成的内容和示例
- 比较：比较不同方法的文章
- 最近更新：Very Recent updates or announcement（最近的更新或公告）
- 多种视角：不同的问题处理方法
测试@Web对话
```
@Web React 19 的最新性能优化
```
查看对话结果
对比@Docs和MCP配置

@Linter Errors使用和测试

@Linter Errors作用和说明
@Linter Errors 符号会自动捕获并提供有关当前活动文件中的任何 linting 错误和警告的上下文。

准备错误代码（BubbleSort.java）

public class BubbleSort {
    /**
     * 冒泡排序方法
     * @param arr 待排序的数组
     */
    public static void bubbleSort(int[] arr) {
        int n = arr.length;
        // 外层循环控制排序轮数
        for (int i = 0; i < n - 1; i++) {
            // 内层循环进行相邻元素比较和交换
            for (int j = 0; j < n - 1 - i; j++) {
                // 如果当前元素大于下一个元素，则交换它们
                if (arr[j] > arr[j + 1]) {
                    int temp = arr[j];
                    arr[j] = arr[j + 1];
                    arr[j + 1] = temp;
                }
            }
        }
    }

    /**
     * 打印数组的辅助方法
     * @param arr 要打印的数组
     */
    public static void printArray(int[] arr) {
        for (int i = 0; i < arr.length; i++) {
            //此处故意出现错误，会出现数组越界
            System.out.print(arr[i+2] + " ");
        }
        System.out.println();
    }

    public static void main(String[] args) {
        // 测试数组
        int[] arr = {64, 34, 25, 12, 22, 11, 90};
        
        System.out.println("排序前的数组：");
        printArray(arr);
        
        // 执行冒泡排序
        bubbleSort(arr);
        
        System.out.println("排序后的数组：");
        printArray(arr);
    }
}

测试@Lint Errors 对话

@Linter Errors 程序运行报错了，你基于报错信息分析下，并且直接解决下错误！

测试结果