能否向VS Code JavaScript语言服务注入代码上下文？扩展实现自定义JSDoc与自动补全

核心可行方案：注入虚拟文件到TypeScript/JavaScript语言服务 #

VS Code的JS/TS语言服务（基于TypeScript）支持通过扩展注入虚拟文件，让语言服务将其视为当前项目的一部分，这样就能直接利用原生的自动补全、悬停文档等功能，效果和真实文件一致，比自定义提供者体验好太多。

具体实现步骤 #

• 获取TS语言服务实例：通过vscode.typescript.typescript模块获取TS API，找到当前文档对应的语言服务宿主和服务实例。
• 创建虚拟文件：将你带JSDoc的JS内容作为虚拟文件内容，分配一个唯一文件名（比如virtual://custom-lib.js），确保符合JS格式。
• 注册虚拟文件到语言服务：修改语言服务宿主的readFile、fileExists等方法，让它们能识别并返回虚拟文件内容；同时通知语言服务文件已更新，触发重新分析。

示例代码片段 #

import * as vscode from 'vscode';
import * as ts from 'typescript';

function setupVirtualFile() {
  const tsApi = vscode.typescript.typescript;
  const workspaceFolder = vscode.workspace.workspaceFolders?.[0];
  if (!workspaceFolder) return;

  // 你的带JSDoc的JS代码内容
  const virtualContent = `/**
 * 自定义工具函数，处理字符串
 * @param {string} str 输入字符串
 * @returns {string} 处理后的字符串
 */
export function processString(str) {
  return str.toUpperCase();
}

/**
 * 配置对象
 * @type {{maxSize: number, enable: boolean}}
 */
export const config = {
  maxSize: 100,
  enable: true
};`;

  // 虚拟文件路径
  const virtualPath = tsApi.sys.resolvePath('virtual://custom-utils.js');

  // 拦截语言服务的文件读取操作
  const originalReadFile = tsApi.sys.readFile;
  tsApi.sys.readFile = (path) => {
    if (path === virtualPath) {
      return virtualContent;
    }
    return originalReadFile(path);
  };

  const originalFileExists = tsApi.sys.fileExists;
  tsApi.sys.fileExists = (path) => {
    if (path === virtualPath) {
      return true;
    }
    return originalFileExists(path);
  };

  // 通知语言服务重新加载项目
  const projectService = (vscode.typescript as any).getProjectService();
  projectService.reloadProjects();
}

// 扩展激活时执行设置
export function activate(context: vscode.ExtensionContext) {
  setupVirtualFile();
}

替代方案：使用类型声明文件 #

如果你的JS代码结构固定，可提前将其转换为.d.ts类型声明文件，在扩展中动态把这个声明文件添加到当前项目的tsconfig.json或jsconfig.json的include列表中，语言服务会自动识别并提供补全和文档。

注意事项 #

• 虚拟文件路径要避免和真实文件冲突，建议用自定义协议前缀（比如virtual://）。
• 扩展停用或项目切换时，要恢复原语言服务宿主方法，避免影响其他项目。
• 动态更新虚拟文件内容后，需重新调用语言服务的reloadProjects或updateFile方法触发更新。

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