Copy AS Ref
轻量级 VS Code / Cursor 扩展：把当前文件路径（可带行号）做成可自定义格式的引用（默认 @path:line），并可按配置送到剪贴板、终端、Codex 或 Cursor Chat/Agent。
功能
三种操作
| 操作 |
快捷键 (Win/Linux) |
快捷键 (macOS) |
作用 |
| 复制为引用 |
Ctrl+Alt+C |
Cmd+Alt+C |
写入剪贴板 |
| 按选区投递 |
Ctrl+Alt+T |
Cmd+Alt+T |
带行号的引用，或把选区送到已勾选的目标 |
| 按文件投递 |
Ctrl+Alt+P |
Cmd+Alt+P |
仅路径（无行号），或把当前文件送到已勾选的目标 |
引用格式示例：
- 光标所在行：
@src/extension.js:33
- 多行选中：
@src/extension.js:10-25
- 仅文件：
@src/extension.js
非工作区文件：Home 下显示为 ~/...，否则尽量用绝对路径；路径统一为正斜杠。
生效范围
Ctrl+Alt+T / Ctrl+Alt+P 会按设置里勾选的目标投递（可多选）：
| 开关 |
默认 |
说明 |
| 终端 |
开 |
把引用文本发到集成终端 |
| Codex |
关 |
把选区/文件加入 Codex 对话（需安装 Codex 扩展） |
| Cursor |
关 |
把选区/文件加入 Cursor Chat / Agent（在 Cursor 中使用） |
- 只开「终端」→ 适合终端里跑的 AI CLI
- 只开「Codex」或「Cursor」→ 不往终端灌文本，只挂到对应对话
- 多个都开 → 每个目标各送一次
使用方式
快捷键
| 系统 |
快捷键 |
说明 |
| macOS |
Cmd+Alt+C |
复制到剪贴板 |
| Windows / Linux |
Ctrl+Alt+C |
复制到剪贴板 |
| macOS |
Cmd+Alt+T |
按生效范围投递（带行号 / 选区） |
| Windows / Linux |
Ctrl+Alt+T |
按生效范围投递（带行号 / 选区） |
| macOS |
Cmd+Alt+P |
按生效范围投递（仅文件） |
| Windows / Linux |
Ctrl+Alt+P |
按生效范围投递（仅文件） |
可在 键盘快捷方式（Cmd+K Cmd+S / Ctrl+K Ctrl+S）中搜索 copyAsRef 改键。
右键菜单
编辑器右键 → Copy AS Ref（等同复制到剪贴板）。
配置
设置里搜索 Copy AS Ref，或直接改 settings.json。改完一般立即生效。
引用格式
| 配置项 |
默认 |
说明 |
copyAsRef.prefix |
@ |
前缀，最多 1 个字符；可留空 |
copyAsRef.lineSeparator |
: |
路径与行号之间的分隔符，必须 1 个字符 |
生效范围
| 配置项 |
默认 |
说明 |
copyAsRef.scope.terminal |
true |
发送到编辑器终端 |
copyAsRef.scope.codex |
false |
添加到 Codex 对话 |
copyAsRef.scope.cursor |
false |
添加到 Cursor Chat / Agent |
示例
工作区结构：
my-project/
├── src/
│ ├── index.js
│ └── utils/
│ └── helper.js
默认配置 (前缀=@, 分隔符=:):
光标在 src/utils/helper.js 第 15 行：
→ 复制为引用: @src/utils/helper.js:15
→ 复制文件名: @src/utils/helper.js
选中 src/utils/helper.js 第 15-30 行：
→ 复制为引用: @src/utils/helper.js:15-30
自定义格式:
前缀=#, 分隔符=: → #src/utils/helper.js:15
前缀=@, 分隔符=# → @src/utils/helper.js#15
前缀=, 分隔符=: → src/utils/helper.js:15 (无前缀)
License
MIT
| |
