如何使用VSCode扩展API实现「另存为」功能？

最近一直在琢磨怎么用VSCode扩展API实现「另存为」功能，折腾了一阵后，整理出一个初步的可行思路，跟大家分享下：

• 第一步：统一转换目标路径为绝对路径
  用户输入的新保存路径可能是相对路径，这时候得基于原文件所在目录把它转换成绝对路径，避免后续操作出现路径错误。用Node.js的path模块就能轻松搞定：

  // 先将给定路径转换为绝对路径
  // 相对路径以原文件所在目录为基准
  const newFileAbsolutePath = path.isAbsolute(saveFileDetails.newPath) 
    ? saveFileDetails.newPath 
    : path.resolve(path.dirname(saveFileDetails.filePath), saveFileDetails.newPath);
  

  这里先通过path.isAbsolute判断输入路径是否已经是绝对路径，如果是就直接用；如果是相对路径，就用path.resolve结合原文件的目录（path.dirname(saveFileDetails.filePath)）生成绝对路径。

• 第二步：借助「untitled-scheme」路径处理文件内容
  接下来要创建一个untitled-scheme格式的路径，这是关键一步——VSCode对untitled类型的文件有专门的处理逻辑，允许我们直接操作文件内容，之后再把内容保存到之前转换好的绝对路径上。这么做的好处是能贴合VSCode自身的文件管理流程，避免直接写入文件时遇到的权限、文件状态同步等问题。

内容的提问来源于stack exchange，提问作者Tyler James Leonhardt