4.4 文件引用与搜索

使用 @ 符号可以快速引用项目中的文件，将文件内容作为上下文提供给AI。

基本用法

# 引用单个文件
@src/main.js 帮我解释这个文件

# 引用多个文件
@package.json @tsconfig.json 检查这些配置是否兼容

模糊搜索

输入 @ 后会触发模糊搜索，帮助快速找到文件：

@mai     → 匹配 src/main.js
@pkg     → 匹配 package.json
@comp    → 匹配 src/components/...

指定行号

可以引用文件的特定行范围：

# 引用特定行
@File#L37

# 引用行范围
@File#L37-42

# 引用从某行到文件末尾
@File#L100-

IDE集成快捷键

在IDE中使用快捷键插入文件引用：

• macOS: Cmd+Option+K
• Windows/Linux: Alt+Ctrl+K

Shell命令输出

使用 ! 前缀执行shell命令，输出作为上下文：

# 列出文件
!ls -la

# Git状态
!git status

# 运行测试
!npm test

组合使用

# 文件 + 命令
@src/app.js !npm test 为什么测试失败了？

# 多文件 + 说明
@package.json @tsconfig.json 帮我升级TypeScript版本

在命令模板中使用

{
  "command": {
    "analyze": {
      "template": "@$1 分析这个文件的代码质量",
      "description": "分析文件"
    }
  }
}

使用：/analyze src/main.js

下一步

核心功能介绍完毕，接下来学习OpenCode的高级配置。