Copy Path / Reference
在 VS Code 中复制文件路径与引用，功能对齐 IntelliJ IDEA 的 Copy Path / Reference。
功能一览
| # |
复制方式 |
说明 |
示例（Windows） |
| 1 |
复制路径 |
绝对路径（系统分隔符） |
e:\a\b |
| 2 |
复制相对路径 |
相对工作区根（系统分隔符） |
a\b |
| 3 |
复制路径(/) |
绝对路径，统一正斜杠 / |
e:/a/b |
| 4 |
复制相对路径(/) |
相对路径，正斜杠 / |
a/b |
| 5 |
复制路径(Unix) |
Unix 风格路径（盘符转为 /盘符） |
/e/a/b |
| 6 |
复制路径(VCS) |
相对版本库根，正斜杠 /（Git、Svn 等） |
a/b |
| 7 |
复制相对路径(VCS) |
相对版本库根，正斜杠 /（Git、Svn 等） |
a/b |
| 8 |
复制引用 |
工作区相对路径，编辑器内附带 行:列 |
a/b:10:3 |
| 9 |
复制文件名 |
文件名（不含扩展名） |
a |
| 10 |
复制文件名(EXT) |
文件名（含扩展名） |
a.b |
覆盖 VSCode 内置的 Copy Path、Copy Relative Path、Copy Filename，并额外支持 Unix 风格、版本库（VCS）相对路径与源码 行:列 引用。
在资源管理器中支持多选，一次性复制多个路径（每行一个）。
使用方法
快速选择面板（推荐）
各右键入口会弹出 复制路径或引用… 选择面板，弹窗内每项实时预览即将复制的路径内容，选中即复制：
复制路径 e:\a\b
复制相对路径 a\b
复制路径(/) e:/a/b
复制相对路径(/) a/b
复制路径(Unix) /e/a/b
复制路径(VCS) a/b
复制相对路径(VCS) a/b
复制引用 a/b:10:3
复制文件名 a
复制文件名(EXT) a.b
入口位置
| 入口 |
触发方式 |
| 资源管理器（Explorer）右键 |
对文件/文件夹右键 → 复制路径或引用… |
| 编辑器文件标签页右键 |
右键标签标题 → 复制路径或引用… |
| 编辑器右键 |
编辑器内右键 → 复制路径或引用… |
| 编辑器标题栏 |
标题栏图标按钮（$(copy)） |
| 命令面板 |
Ctrl+Shift+P → 路径: 复制路径或引用… |
快捷方式
| 命令 |
快捷键 |
| 复制引用（直接复制，不弹窗） |
Ctrl+Alt+Shift+C（macOS Cmd+Alt+Shift+C） |
快捷键直接复制引用，跳过选择面板；其余各类型复制仍可经由命令面板单独调用。
路径规则
- 工作区根：文件所在工作区文件夹（支持多根）；文件在工作区外时回退为绝对路径。
- VCS 根：优先
git rev-parse --show-toplevel，其次 svn info --show-item wc-root；两者都不可用时回退工作区根。
- 相对路径：一律以正斜杠
/ 分隔（Unix 变体）；系统分隔符变体保留 Windows \。
- 复制引用：仅当前激活编辑器与目标一致时附带
行:列。
设置
paths.previewSpaces：控制选择面板中路径预览的对齐。键为弹窗标签名，值为标签后填充的空格数量；未配置的项使用内置默认值。
{
// settings.json 示例
"paths.previewSpaces": {
"复制路径": 8,
"复制相对路径": 4,
"复制路径(/)": 5,
"复制相对路径(/)": 1,
"复制路径(Unix)": 2,
"复制路径(VCS)": 3,
"复制相对路径(VCS)": 0,
"复制引用": 8,
"复制文件名": 8,
"复制文件名(EXT)": 3
}
}
值越大预览越靠右；只写需要调整的项即可，其余沿用默认。
开发调试
npm install
npm run compile
按 F5 打开 Extension Development Host 即可调试。
更多构建 / 打包 / 发布流程见 BUILD.md（随源码同目录）。
License
MIT
