Copy AS Ref

ts-org

8 installs

智能代码引用工具 - 快速生成可自定义格式的文件路径引用，支持三种输出模式：剪贴板复制、终端直接发送、文件名快速引用。可配置前缀符号与行号分隔符，适配多种工作场景，完美支持文档编写、Issue追踪、AI辅助编程、代码审查与团队协作。零剪贴板污染，即时响应，提升开发效率的必备利器。

Installation

Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.

Copied to clipboard

More Info

Copy AS Ref

一个轻量级 VS Code 扩展，快速将文件路径和行号以自定义格式复制到剪贴板，方便在文档、Issue、AI编辑器、聊天中引用代码位置。

默认格式为 @path:line，支持自定义前缀符号(如 #、@ 或无前缀)。

功能

提供三种复制方式：

复制为引用 (Cmd+Alt+C)：复制当前文件的路径和行号到剪贴板
- 无选中 / 光标所在行：@src/extension.js:33
- 多行选中：@src/extension.js:10-25
发送到终端 (Cmd+Alt+T)：直接发送路径和行号到终端，不经过剪贴板
- 自动显示终端窗口
- 不会在剪贴板历史中留下记录
发送文件名到终端 (Cmd+Alt+P)：直接发送文件名(不带行号)到终端，不经过剪贴板
- 输出：@src/extension.js
- 适合快速引用整个文件

修复非工作区文件路径显示问题：Home 目录文件显示为 ~ 格式，其他文件显示绝对路径，不再只显示文件名。

使用方式

快捷键

系统	快捷键	说明
macOS	`Cmd+Alt+C` (⌘⌥C)	复制到剪贴板
Windows / Linux	`Ctrl+Alt+C`	复制到剪贴板
macOS	`Cmd+Alt+T` (⌘⌥T)	复制带行号并粘贴到终端
Windows / Linux	`Ctrl+Alt+T`	复制带行号并粘贴到终端
macOS	`Cmd+Alt+P` (⌘⌥P)	复制文件名(不带行号)并粘贴到终端
Windows / Linux	`Ctrl+Alt+P`	复制文件名(不带行号)并粘贴到终端

说明:

Cmd+Alt+C: 复制到剪贴板，可在任意位置粘贴使用
Cmd+Alt+T / Cmd+Alt+P: 直接发送到终端，不经过剪贴板，不会在剪贴板历史中留下记录

光标放在任意行，按下快捷键即可复制。选中多行时会包含行号范围。

可在 VS Code 的 键盘快捷方式（Cmd+K Cmd+S / Ctrl+K Ctrl+S）中搜索 copyAsRef 自定义快捷键。

右键菜单

在编辑器中右键 → Copy AS Ref，效果与快捷键相同。

配置

可以在 VS Code 设置中自定义引用格式：

前缀符号

配置项: copyAsRef.prefix
默认值: @
说明: 引用路径的前缀符号，最多一个字符。例如：@、# 或留空(不使用前缀)

行号分隔符

配置项: copyAsRef.lineSeparator
默认值: :
说明: 路径和行号之间的分隔符，必须为一个字符，不能为空。例如：:、#、| 等

设置方式

打开 VS Code 设置 (Cmd+, / Ctrl+,)
搜索 "Copy AS Ref"
在相应输入框中输入自定义的符号

修改配置后无需重启，下次使用命令时自动生效。

示例

工作区结构：
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