VSCode复制相对路径需满足三前提：文件已保存、工作区已打开、设置已启用；否则命令静默失败，且路径始终相对于工作区根目录而非当前文件夹。
VSCode 里复制相对路径不是“点一下就完事”，必须满足三个前提：文件已保存、工作区已打开（File > Open Folder）、设置已启用——缺一不可。
为什么 Ctrl+Shift+P 搜 “Copy Relative Path” 没反应或复制出空值
常见原因不是命令不存在，而是触发条件不满足：
- 当前文件是
Untitled-1这类未保存的临时标签页 → 先按Ctrl+S保存为真实文件 - 只是双击打开了单个
.js文件，没通过File > Open Folder加载整个项目 → VSCode 没有工作区根目录，无法计算“相对” - 命令面板里搜
copy relative匹配到的是workbench.action.files.copyRelativePath，但该命令在无工作区时会静默失败，不报错也不提示 - 多根工作区下，它只以当前文件所在的那个文件夹为基准，不是最外层工作区根目录
右键菜单没有“复制相对路径”？先开开关再重启资源管理器
VSCode 默认隐藏这两个右键项，必须手动开启：
- 打开设置（
Ctrl+,），搜索explorer.copyRelativePath，勾选Explorer: Copy Relative Path - 同样搜索
explorer.copyPath，勾选Explorer: Copy Path（这是绝对路径选项） - 改完后按
Ctrl+Shift+E切换一次资源管理器，或直接关闭再打开侧边栏，才能生效 - 如果某个项目里仍不显示，检查项目根目录下的
.vscode/settings.json是否有"explorer.copyRelativePath": false—— 直接删掉或改成true
快捷键怎么配才真正“一键”复制相对路径
推荐用原生命令 workbench.action.files.copyRelativePath 绑定快捷键，但要注意限制条件：
- 命令 ID 必须写全：
workbench.action.files.copyRelativePath（别漏掉workbench.action.files.前缀） - 绑定时加
when条件：resourceScheme != 'untitled' && activeEditorIsDirty == false，防止对未保存文件误触发 - 示例 JSON 配置（放入键盘快捷方式 JSON）：
[{"key":"alt+r","command":"workbench.action.files.copyRelativePath","when":"resourceScheme != 'untitled' && activeEditorIsDirty == false"}] - 别用
Ctrl+C类组合——容易和编辑器内复制冲突；macOS 上避开Cmd+Shift+G这类系统级快捷键
粘贴进 import 或终端前，这几个隐性差异必须处理
复制出来的路径看着干净，但实际使用时容易栽跟头：
- 路径不含
./前缀（比如输出src/utils.ts，不是./src/utils.ts），写import时得自己补上，否则 Node.js 可能报Cannot find module - 路径用正斜杠
/，Windows CMD 或旧批处理里可能需手动替换为\ - 路径含空格或中文时，直接丢进终端命令会出错（如
node C:/my project/app.js），必须加英文双引号包裹："C:/my project/app.js" - 多根工作区下，相对路径不会跨根目录解析——哪怕两个文件夹物理上相邻，只要不属于同一工作区根，就无法生成有效相对引用
最常被忽略的一点：相对路径依赖的是「当前工作区根目录」，而不是「当前文件所在目录」。很多人在子目录里编辑文件，以为复制出来的是相对于该子目录的路径，结果粘贴进 import 语句里却找不到模块——其实它始终是相对于你最初 Open Folder 的那个文件夹。
