VSCode无内置快捷键复制相对路径，需满足文件已保存、工作区已打开（File > Open Folder）、设置explorer.copyRelativePath为true三前提；命令输出路径始终相对于当前工作区根目录，多根工作区下以文件所在子文件夹为基准，分隔符统一为/。
VSCode 本身没有内置快捷键直接复制当前文件的相对路径，但可以通过组合操作或简单配置实现“秒级复制”，关键在于理解 Copy Relative Path 命令的行为边界和触发方式。
为什么 Copy Relative Path 复制的是工作区根目录下的相对路径？
这个命令（默认快捷键 Ctrl+Shift+Alt+P / Cmd+Shift+Alt+P）输出的是相对于当前打开的 workspace folder 根目录的路径，不是相对于项目根或 Git 仓库根。如果 VSCode 是以单个文件打开（没打开文件夹），该命令会失效——此时根本不存在“相对路径”的上下文。
- 必须通过
File → Open Folder...打开整个项目目录，才能让Copy Relative Path正常工作 - 若工作区含多个文件夹，它只对当前活动编辑器所在文件夹生效
- 路径分隔符统一为
/（即使在 Windows 上），适合跨平台共享
如何把 Copy Relative Path 绑定成更顺手的快捷键？
默认组合键太难按，建议重映射到更易触发的组合，比如 Ctrl+Alt+C。操作路径：Ctrl+Shift+P → 输入 Preferences: Open Keyboard Shortcuts (JSON) → 在 JSON 中添加：
[
{
"key": "ctrl+alt+c",
"command": "copyRelativePath",
"when": "editorTextFocus"
}
]
注意：when 条件确保只在编辑器有焦点时生效，避免误触；不要用 Ctrl+C 这类全局键，否则会覆盖复制文本功能。
团队共享时，相对路径容易出错的三个典型场景
复制出来的路径看似简洁，但在实际协作中常因环境差异失效：
- 成员本地工作区根目录不同（比如有人开
./src，有人开./）→ 路径解析失败 - 路径含中文或空格，未被 URL 编码 → 粘贴到 Markdown 或 Slack 后链接失效
- 想引用的是 TypeScript 模块路径（如
@/components/Button），但Copy Relative Path输出的是物理路径（src/components/Button.tsx）→ 二者语义不等价
真正省时间的不是“复制路径”这个动作，而是所有人对“相对起点”有一致认知。工作区目录结构、是否启用 path alias、甚至文档里写路径时加不加 ./ 前缀，这些细节比快捷键本身更影响效率。
