VSCode扩展开发：如何获取从工作区根目录起始的文件相对路径

VSCode提供了专门的内置API实现该需求，无需自行编写正则表达式、手动处理URL编码的路径片段即可完成相对路径提取

核心可用API #

• vscode.workspace.asRelativePath()
  这是专门面向该场景设计的官方方法，核心逻辑会自动匹配文件所属的工作区根目录，剥离根目录对应的全路径前缀，直接返回从根目录起始的相对路径片段。该方法是VSCode核心功能（如资源管理器文件路径展示、调试配置路径解析）内部使用的同一套逻辑，可靠性远高于自行实现的路径截取逻辑。
  方法内置了URI解码、跨平台路径格式兼容、多工作区自动匹配的处理能力，不管路径中是否包含%20这类URL编码的特殊字符，都能精准匹配剥离工作区根的路径段。
• 多工作区精细化适配场景
  如果需要主动指定匹配的工作区根目录，可以先通过vscode.workspace.getWorkspaceFolder(fileUri)拿到文件对应的工作区根URI，再通过VSCode内置的Uri实例方法计算相对路径，全程不需要手动处理编码问题。

实际场景代码示例 #

针对给出的典型场景——工作区根为My App，当前文件全编码URI为file:///c%3A/Users/Bob/Documents/My%20App/backend/connections/server.js，实现代码如下：

import * as vscode from 'vscode'

// 获取当前激活编辑器的文档URI
const activeEditor = vscode.window.activeTextEditor
if (!activeEditor) return
const currentFileUri = activeEditor.document.uri

// 直接调用内置方法提取相对路径
const relativePath = vscode.workspace.asRelativePath(currentFileUri)
// 输出值完全匹配预期：backend/connections/server.js

注意事项 #

• 该方法的入参既可以传入带编码的Uri对象，也可以传入解码后的本地文件系统路径字符串，两种入参形式都能正常识别
• 无需手动对URI做decodeURI解码再做字符串截取，内置API会自动处理编码解析，避免因特殊字符编码带来的路径匹配错误
• 多工作区场景下，方法会自动识别文件所属的工作区根目录，不会出现跨根目录匹配错误

内容的提问来源于stack exchange，提问作者user6680