在介绍了 Cherry Studio 的一键配置后,今天我们来看看开发者最常用的编辑器 —— Visual Studio Code (VS Code)。
作为开发者,我们经常需要实现这样的场景:
- 在错误日志页面点击路径,直接在本地 VS Code 中打开对应的文件并定位到报错行。
- 在 CLI 工具执行完任务后,自动打开生成的项目目录。
- 引导用户一键连接到远程服务器并打开指定的开发目录。
- 在教程文档中提供一个按钮,一键打开相关的配置文件。
VS Code 协议与深度链接
Visual Studio Code 提供了强大的深度链接(Deep Links)支持,允许开发者通过 vscode:// 协议从外部应用、网页或命令行直接触发编辑器操作。
然而,手动拼接这些链接通常涉及复杂的路径处理、行号列号计算以及繁琐的字符编码。
现在,通过 Protocol Launcher,你可以将这些操作封装成简单的函数调用,实现优雅的应用唤起。
核心能力:精确控制与远程支持
Protocol Launcher 为 VS Code 专门提供了 protocol-launcher/vscode 模块,支持以下核心功能:
快速上手
首先,确保你的项目中已安装:
npm install protocol-launcher
在代码中你可以根据场景选择两种导入方式:
- 按需加载(通过子路径导入),支持 Tree Shaking,体积更小;
- 全量导入(从根包导入),写法更简单,但会引入所有已支持应用的逻辑。
// ✅ 推荐:按需加载 VS Code 模块
import { openFile, openFolder, openRemote, openSettings, installMCP } from 'protocol-launcher/vscode'
// 也可以从根包导入,但会包含所有应用模块
// import { vscode } from 'protocol-launcher'
场景一:安装 STDIO MCP 服务 (installMCP)
下面的示例会安装官方的 server-everything 测试服务器,适合用来验证 VS Code 对 MCP 能力的支持情况:
import { installMCP } from 'protocol-launcher/vscode'
const url = installMCP({
name: 'server-everything', // 服务名称,用于显示和标识
type: 'stdio', // 通信类型,支持 stdio, streamable_http, sse 等
command: 'npx', // 启动命令,如 npx, docker 等
args: ['-y', '@modelcontextprotocol/server-everything'], // 启动参数
})
你可以把生成的 url 绑定到按钮或链接上,让用户一键在 VS Code 中完成 MCP 服务的添加。
场景二:安装 Streamable HTTP 类型 MCP 服务 (installMCP)
对于托管在云端的 MCP 服务,可以使用 streamable_http 传输协议,并通过 url + headers 进行鉴权:
import { installMCP } from 'protocol-launcher/vscode'
const url = installMCP({
name: '企查查企业信息 MCP', // 服务名称,用于显示和标识
type: 'streamable_http', // 通信类型,支持 stdio, streamable_http, sse 等
url: 'https://mcp.qcc.com/basic/stream', // 服务地址
headers: { // 自定义请求头,用于鉴权等
Authorization: 'YOUR_QCC_TOKEN',
},
})
场景三:安装 SSE 类型 MCP 服务 (installMCP)
如果你的服务基于 Server-Sent Events(SSE)向 VS Code 推送结果,也可以通过 type: 'sse' 的方式进行安装:
import { installMCP } from 'protocol-launcher/vscode'
const url = installMCP({
name: '企查查风险信息 MCP', // 服务名称,用于显示和标识
type: 'sse', // 通信类型,支持 stdio, streamable_http, sse 等
url: 'https://mcp.qcc.com/basic/sse', // 服务地址
headers: { // 自定义请求头,用于鉴权等
Authorization: 'YOUR_QCC_TOKEN',
},
})
场景四:精确打开文件 (openFile)
你可以指定文件路径、行号和列号,甚至决定是否在新窗口中打开。这对于错误监控系统或日志分析工具非常有用:
import { openFile } from 'protocol-launcher/vscode'
const url = openFile({
path: '/Users/dev/project/src/index.ts', // 文件的绝对路径
line: 42, // 可选: 跳转到第 42 行
column: 10, // 可选: 跳转到第 10 列
openInNewWindow: true, // 可选: 是否在新窗口打开
})
场景五:打开文件夹或工作区 (openFolder)
在脚手架工具或自动化脚本执行完任务后,自动为用户打开项目目录:
import { openFolder } from 'protocol-launcher/vscode'
const url = openFolder({
path: '/Users/dev/project', // 文件夹的绝对路径
openInNewWindow: false, // 可选: 是否在新窗口打开
})
场景六:远程开发连接 (openRemote)
如果你需要引导用户连接到远程服务器进行开发,可以直接生成 SSH 远程连接链接。这极大简化了远程环境的配置流程:
import { openRemote } from 'protocol-launcher/vscode'
const url = openRemote({
type: 'ssh-remote', // 远程类型,支持 ssh-remote, wsl, dev-container
host: 'root@172.18.105.209:22', // 远程主机标识,如 root@IP 或 SSH Alias
path: '/code/my-project', // 远程环境内的路径
})
场景七:一键打开设置界面 (openSettings)
如果你正在开发一个 VS Code 插件或相关工具,可以通过此链接引导用户去修改设置:
import { openSettings } from 'protocol-launcher/vscode'
const url = openSettings()
为什么选择 Protocol Launcher?
- 推荐方式:使用子路径导入(如 import { openFile } from 'protocol-launcher/vscode'),这样构建工具只会打包与 VS Code 相关的代码,不会引入其他无关应用的逻辑。
- 全量方式:如果你在编写简单的脚本或演示,也可以从根包导入(如 import { vscode } from 'protocol-launcher'),但这会包含库中所有支持的应用模块。建议生产环境始终使用按需加载。
结语
VS Code 的深度链接支持非常强大,而 Protocol Launcher 将其封装得更加易用且稳健。无论是在 Web 页面还是命令行工具中,它都是唤起编辑器的最佳方案。
🔗 相关链接
- Protocol Launcher 官网: https://protocol-launcher.huayi-data.com/
- VS Code 模块文档: VS Code | Protocol Launcher







