尧图网站建设 
开发工具CLI后端【免费下载链接】saplingA Scalable, User-Friendly Source Control System.项目地址https://gitcode.com/gh_mirrors/sa/sapling点击查看免费下载导读SaplingScalable, User-Friendly Source Control System是 Meta 开源的现代化源码控制系统而本仓库 addons/vscode 正是其官方 VS Code 扩展。该扩展将 Sapling 的核心交互界面——Interactive Smartlog交互式智能日志简称 ISL——以 Webview 形式嵌入 VS Code让你在不离开编辑器的前提下完成提交、栈操作、比较视图、代码评审等日常工作。阅读本文后你将掌握扩展的安装与前置条件、两种启动 ISL 的方式、全部可配置项、命令清单及其底层实现原理。一、扩展定位为 VS Code 注入 Sapling 的交互式智能日志addons/vscode/README.md开门见山地定义了扩展的核心价值该扩展提供与 Sapling 的集成包括一个 Webview 形式的 Interactive Smartlog UI——与你运行sl web命令得到的界面完全一致。这里有几个关键概念需要先厘清Sapling SCM 本身是一个独立的源码控制系统提供sl命令行工具sl.exe是 Windows 下的可执行文件其核心能力包括智能日志、提交栈stack、云端同步Commit Cloud等。本扩展是 Sapling 与 VS Code 之间的桥梁它不重新实现版本控制逻辑而是把 ISL 前端界面位于 addons/isl与 Sapling 后端命令通过 Webview 消息通道连接起来。sl web是 Sapling 命令行提供的在浏览器中打开 ISL的能力扩展复用了同一套 ISL 前端只是把宿主从浏览器换成了 VS Code 的 Webview 面板。一个重要前提扩展不包含 Sapling 本体README.md中有一句醒目的注意事项该扩展不包含 Sapling SCM 本身。你必须先通过 Sapling 的正常安装流程安装好 Sapling SCM确保sl命令在 PATH 中扩展才能正常工作。这一点在源码中也有印证——extension/config.ts 中的getCLICommand()会读取sapling.commandPath配置未配置时默认使用slWindows 为sl.exe扩展的所有仓库操作都通过调用这个 CLI 命令完成// addons/vscode/extension/config.ts export function getCLICommand(): string { return ( vscode.workspace.getConfiguration(sapling).get(commandPath) || (os.platform() win32 ? sl.exe : sl) ); }二、安装与前置条件1. 安装 Sapling SCM在安装扩展之前请先完成 Sapling SCM 本体的安装并确认sl --version可以正常执行。安装完成后将包含sl的目录加入系统 PATH。2. 安装扩展从 VS Code 扩展市场搜索 Sapling SCM发布者为 meta即可安装。从仓库 addons/vscode/package.json 可以看到当前版本的元数据字段值namesapling-scmversion0.1.71publishermetalicenseMITengines.vscode^1.86.0要求 VS Code 1.86 及以上categoriesSCM Providers扩展的激活事件activationEvents包括onStartupFinished、onCommand:sapling.open-isl、onWebviewPanel:sapling.isl、onView:sapling.isl这意味着扩展会在 VS Code 启动完成后或首次需要它时自动激活无需手动干预。三、启动 Interactive Smartlog 的两种方式README.md明确给出了两种启动 ISL 的途径方式一通过命令面板在 VS Code 中打开命令面板CtrlShiftP/CmdShiftP运行Sapling SCM: Open Interactive Smartlog命令。该命令在 package.json 中注册为sapling.open-isl其实际处理逻辑位于 islWebviewPanel.ts 的registerISLCommands中。方式二自定义键盘快捷键如果你更喜欢键盘操作可以在 VS Code 的keybindings.json中为sapling.open-isl命令绑定自己的快捷键{ key: ctrlalts, command: sapling.open-isl }值得一提的是扩展本身也内置了默认快捷键绑定见 package.json 的keybindings段sapling.open-islCtrlShiftImacOS 为CmdShiftI但仅当isl.openInteractiveSmartlogShortcutEnabled上下文为真时生效sapling.open-comparison-view-uncommittedCtrlmacOSCmdsapling.open-comparison-view-headCtrlShiftmacOSCmdShiftsapling.open-commentsAltShiftGsapling.toggle-inline-commentsAltShiftT。更多入口除了 README 提到的两种方式从 package.json 的contributes.menus可以看到 ISL 还有更多触发入口SCM 标题栏按钮当scmProvider sapling时SCM 面板标题栏会出现打开 ISL 的入口编辑器标题栏按钮配置sapling.isl.showOpenOrFocusButtonOnEditorTitle为true默认开启时活动编辑器标题栏会显示打开/聚焦 ISL 的按钮活动栏/侧边栏视图配置sapling.isl.showInSidebar为true后ISL 会作为侧边栏 Webview 视图常驻视图 id 为sapling.isl。四、原理剖析Webview ISL 与sl web的关系README 强调扩展的 ISL UI as you would get by runningsl web。理解这一点的实现机制有助于你更好地使用和调试扩展。1. Webview 的创建与复用islWebviewPanel.ts 中的createOrFocusISLWebview()负责创建或聚焦 ISL 面板如果 ISL 面板已存在则直接reveal()复用并通过changeActiveRepo消息切换到指定仓库的 cwd工作目录否则调用vscode.window.createWebviewPanel(sapling.isl, ...)创建一个新的 Webview 面板标题为 Interactive Smartlog。整个 VS Code 扩展进程内只维护一个共享的 ISL Webview模块级变量islPanelOrViewResult切换仓库时通过消息通知前端重定向而不是为每个仓库各开一个面板。2. Webview HTML 与安全策略htmlForWebview.ts 负责生成 Webview 的 HTML生产模式同步写入带严格 Content-Security-PolicyCSP的 HTML所有脚本通过nonce白名单放行script-src还允许wasm-unsafe-evalISL 依赖 WASM 模块开发模式NODE_ENVdevelopment时先从本地 Vite dev serverhttp://localhost:3015见devPort常量拉取实时编译的 HTML再注入自定义样式与初始脚本兼容性样式自动继承 VS Code 编辑器的editor.fontLigatures与editor.tabSize配置让 ISL 内嵌代码区域与编辑器观感一致。3. 前端与后端的消息通信ISL Webview 与 Sapling 后端之间通过postMessage双向通信后端到前端panelOrView.webview.postMessage(message)前端到后端通过onDidReceiveMessage监听消息序列化使用 ISL 共享模块的serializeToString/deserializeFromString见 addons/isl/src/serialize.ts。连接建立后onClientConnection会注入仓库上下文cwd、command、platform、version等ISL 前端据此向sl命令发起操作请求。4. 状态持久化ISL 的 UI 状态如筛选条件、展开的提交保存在 VS Code 的globalState中。getInitialStateJs会把持久化状态以 JSON 形式注入 Webview HTMLkey 前缀为isl-persisted:实现启动时的同步恢复同时包含旧版单一 key 存储isl-persisted到逐 key 存储的迁移逻辑。五、配置项详解扩展在 VS Code 设置中以sapling.*前缀暴露全部配置声明于 package.json 的contributes.configuration中文说明对应 package.nls.json。下表列出全部配置项及其默认值配置项类型默认值说明sapling.commandPathstring指定用于运行 Sapling 命令的可执行文件路径留空则使用 PATH 中的slWindows 为sl.exe。修改后需重启 VS Code 生效sapling.showInlineBlamebooleantrue浏览 Sapling 仓库文件时在光标附近显示行内 blame 标注sapling.showDiffCommentsbooleantrue是否显示代码评审Phabricator Diff评论与行内代码建议sapling.inlineCommentDiffViewModeenumUnified代码建议以统一视图还是分割视图呈现Unified/Splitsapling.markConflictingFilesResolvedOnSavebooleantrue保存文件后若文件中已无冲突标记则自动将该文件标记为冲突已解决sapling.comparisonPanelModeenumAlways Separate Panel比较视图的展示方式AutoISL 激活时在 ISL 内展示否则用 VS Code 原生 multi-diff 编辑器/Always Separate Panel始终使用原生 multi-diff 编辑器sapling.isl.openBesidebooleanfalse为true时文件、diff 与比较视图将打开在 ISL 面板旁边ViewColumn.Beside而非同一列便于点击文件时 ISL 保持可见sapling.isl.showInSidebarbooleanfalse为true时 ISL 以侧边栏视图呈现为false时以普通编辑器面板呈现。修改后需重启完全生效sapling.isl.showOpenOrFocusButtonOnEditorTitlebooleantrue在活动编辑器标题/标签栏显示打开或聚焦 ISL按钮sapling.isl.showInlineSignalsenumall控制编辑器中行内 diff 信号CI 结果如 lint 错误、测试失败等的显示级别all/errors warnings/errors/nonesapling.isl.inlineSignalsRenderModeenuminset行内信号渲染方式inset内嵌 Webview带丰富控件/diagnostics标准 VS Code diagnostics 与波浪线关于commandPath的实现细节如前所述config.ts 的getCLICommand()是命令行解析的核心。需要特别留意的是commandPath的修改需要重启 VS Code才能生效源码注释明确说明该值会被缓存复用如果 Sapling 可执行文件不在 PATH 中你可以把绝对路径写进commandPath例如C:\\tools\\sapling\\sl.exe或/usr/local/bin/sl。六、命令大全扩展注册的命令完整清单见 package.json 的contributes.commands按功能可分为以下几类ISL 相关命令 ID显示名称sapling.open-islOpen Interactive Smartlog (ISL)sapling.isl.focusFocus Sapling ISL Sidebarsapling.close-isl关闭 ISL 面板/侧边栏编程式调用Diff 与比较视图命令 ID显示名称sapling.open-file-diff-uncommittedOpen Diff View For Current File (Uncommitted Changes)sapling.open-file-diff-headOpen Diff View For Current File (Head Changes)sapling.open-file-diff-stackOpen Diff View For Current File (Stack Changes)sapling.open-comparison-view-uncommittedOpen Comparison Viewer (Uncommitted Changes)sapling.open-comparison-view-headOpen Comparison Viewer (Head Changes)sapling.open-comparison-view-stackOpen Comparison Viewer (Stack Changes)sapling.open-multi-diff-file-headOpen Working Copy File文件操作与远程链接命令 ID显示名称sapling.revert-fileRevert uncommitted change to this filesapling.open-remote-file-linkOpen in Code Reviewsapling.copy-remote-file-linkCopy Code Review Link代码评审评论命令 ID显示名称sapling.open-commentsOpen Code Review Comments Panelsapling.toggle-inline-commentsToggle Show/Hide Inline Code Review CommentsWorktree 操作需 EdenFS命令 ID显示名称sapling.worktree.switchSwitch Worktreesapling.worktree.addAdd Worktreesapling.worktree.removeRemove Worktreesapling.worktree.renameRename Worktree这些命令的实际实现集中在 extension/commands.ts 的vscodeCommands对象中通过registerCommands()统一注册并在执行时自动上报遥测事件RunVSCodeCommand。七、深度集成功能1. Diff 视图三种比较范围对当前文件你可以打开三种 diff 视图对应sapling.open-file-diff-*系列命令Uncommitted Changes未提交变更比较工作区与上次提交Head ChangesHEAD 变更比较当前提交与公开祖先Stack Changes栈变更比较整个提交栈。从源码看commands.ts 中的openDiffView通过vscode.diff命令打开左右两侧对比左侧before与右侧after的 revset 由 shared/Comparison.ts 的beforeRevsetForComparison/currRevsetForComparison计算。值得注意的实现细节未提交/HEAD 比较的右侧直接使用file://URI因此你可以在 diff 视图右侧直接编辑文件比较历史提交或子模块变更时右侧则使用自定义 scheme 的 URIsapling-diff此时右侧是只读内容被删除的文件通过DeletedFileContentProvider提供内容确保删除的文件也能正常参与 diff。2. 比较视图与原生 multi-diff 编辑器sapling.open-comparison-view-*系列命令会打开整个仓库层面的比较。扩展会优先尝试 VS Code 原生 multi-diff 编辑器openNativeMultiDiffEditor失败时回退到 Webview 比较面板。排序时还会调用generatedFilesDetector检测生成文件把手动文件排在前面、生成文件排到后面。3. 行内 Blame开启sapling.showInlineBlame后浏览文件时光标附近会显示行内 blame 标注。该功能由 extension/blame/blame.ts 的InlineBlameProvider实现并在 extension.ts 的activate中按 SCM API 能力开关注册默认能力集为blame与sidebar。4. 行内代码评审评论扩展支持在编辑器中显示 Phabricator Diff 的行内评论与代码建议相关命令为sapling.open-comments与sapling.toggle-inline-comments。评论面板作为 SCM 区域的 Webview 视图idsapling.comments提供。行内建议的 diff 视图模式由sapling.inlineCommentDiffViewMode控制。5. Worktree 管理sapling.worktree.*系列命令让你在 VS Code 中直接管理 Sapling 的 worktree工作树。需要特别说明的限制从 commands.ts 的resolveWorktreeRepo可以看出仅支持 EdenFS 仓库非 EdenFS 仓库会提示 Worktrees require EdenFSGitHub 代码评审类型的仓库不支持 worktree。八、扩展架构与启动流程从 extension/extension.ts 的activate入口可以看到完整的装配流程activate() ├── 创建输出通道日志Sapling ISL Output Channel ├── 初始化平台抽象vscodePlatform ├── 构造 RepositoryContextcmd / cwd / logger / tracker ├── 加载翻译i18n并查询启用的 SCM API 特性 ├── registerISLCommands()注册 ISL Webview 面板/视图与相关命令 ├── VSCodeReposList管理当前工作区内的 Sapling 仓库 ├── InlineBlameProvider行内 blame ├── registerSaplingDiffContentProvider / DeletedFileContentProviderdiff 内容提供者 ├── registerCommands()注册其余命令 └── makeExtensionApi()暴露扩展 API几个关键设计仓库缓存repositoryCacheisl-server/src/RepositoryCache.ts按路径缓存Repository实例避免重复初始化平台抽象vscodePlatform.ts实现了ServerPlatform接口把 ISL 前端发来的platform/openFiles等平台消息翻译为 VS Code 的打开文件、跳转行号等操作孤儿面板恢复当扩展宿主extension host重启而 ISL 面板仍存在时replaceExistingOrphanedISLWindows会检测失效的 ISL 标签页并在原位置重建这是对 VS Code 已知行为——Webview 面板序列化不生效——的补偿源码注释引用了 microsoft/vscode issue 188257。九、开发与构建如果你希望从源码构建或调试该扩展package.json 提供了完整的脚本脚本作用yarn watch-extension以 watch 模式构建扩展主进程rolldownyarn watch-webview以 watch 模式启动 Webview 的 Vite dev server端口 3015yarn build-extension生产构建扩展主进程yarn build-webview生产构建 Webview 前端yarn test运行 Jest 测试覆盖 extension/tests下的命令、Webview 面板、平台适配等yarn lintoxlint 静态检查开发模式下Webview 会从http://localhost:3015实时加载 Vite 编译产物并自动注入 VS Code 兼容样式实现前端热更新调试。十、版本演进与使用建议从 CHANGELOG.md 可以追踪扩展的演进脉络近期版本持续优化了提交图过滤的输入防抖、CI 信号徽章批量查询、生成文件排序、worktree 命令面板入口等。早期版本还引入了 absorb将未提交变更分发进提交栈等特性。实际使用中请记住几个容易踩坑的点扩展 ≠ Sapling 本体先装好 Sapling SCM确认sl可用否则扩展无法工作commandPath与showInSidebar修改后需重启这两个配置在激活早期即被读取并缓存ISL 面板全局唯一扩展复用同一个 ISL Webview多仓库场景下通过 cwd 切换而不是打开多个面板worktree 功能有前置约束需要 EdenFS 且代码评审系统非 GitHub。掌握以上内容后你就可以把 VS Code 当作 Sapling 的完整操作台用CtrlShiftI唤起 ISL在编辑器内完成提交、栈管理、比较与代码评审的全部日常工作。赞分享开发工具CLI后端【免费下载链接】saplingA Scalable, User-Friendly Source Control System.项目地址https://gitcode.com/gh_mirrors/sa/sapling点击查看免费下载相关推荐Sapling SCM VS Code扩展在IDE中无缝管理代码版本的完整指南Sapling SCM VS Code扩展在IDE中无缝管理代码版本的完整指南 Sapling SCM VS Code扩展是开发者在IDE中高效管理代码版本的开发工具CLI后端PRQL × Visual Studio Code在编辑器内实时编译 PRQL 查询为 SQL 的官方扩展实战指南PRQL × Visual Studio Code在编辑器内实时编译 PRQL 查询为 SQL 的官方扩展实战指南 PRQLPipelined Relati文档教程技术博客Relay 编辑器支持基于 Rust 编译器的 LSP 语言服务与 VS Code 官方扩展实战指南Relay 编辑器支持基于 Rust 编译器的 LSP 语言服务与 VS Code 官方扩展实战指南 Relay 的 Rust 编译器对代码中嵌入的 Grap前端开发工具上一篇3 分钟跑通 awesome-claude-codeClaude Code 精选资源大全维护指南下一篇TypeScript 接口合并与扩展Merging and Extension声明合并、继承与交叉类型完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Sapling SCM 官方 VS Code 扩展实战指南：在编辑器内驾驭 Interactive Smartlog（ISL）
开发工具CLI后端【免费下载链接】saplingA Scalable, User-Friendly Source Control System.项目地址https://gitcode.com/gh_mirrors/sa/sapling点击查看免费下载导读SaplingScalable, User-Friendly Source Control System是 Meta 开源的现代化源码控制系统而本仓库 addons/vscode 正是其官方 VS Code 扩展。该扩展将 Sapling 的核心交互界面——Interactive Smartlog交互式智能日志简称 ISL——以 Webview 形式嵌入 VS Code让你在不离开编辑器的前提下完成提交、栈操作、比较视图、代码评审等日常工作。阅读本文后你将掌握扩展的安装与前置条件、两种启动 ISL 的方式、全部可配置项、命令清单及其底层实现原理。一、扩展定位为 VS Code 注入 Sapling 的交互式智能日志addons/vscode/README.md开门见山地定义了扩展的核心价值该扩展提供与 Sapling 的集成包括一个 Webview 形式的 Interactive Smartlog UI——与你运行sl web命令得到的界面完全一致。这里有几个关键概念需要先厘清Sapling SCM 本身是一个独立的源码控制系统提供sl命令行工具sl.exe是 Windows 下的可执行文件其核心能力包括智能日志、提交栈stack、云端同步Commit Cloud等。本扩展是 Sapling 与 VS Code 之间的桥梁它不重新实现版本控制逻辑而是把 ISL 前端界面位于 addons/isl与 Sapling 后端命令通过 Webview 消息通道连接起来。sl web是 Sapling 命令行提供的在浏览器中打开 ISL的能力扩展复用了同一套 ISL 前端只是把宿主从浏览器换成了 VS Code 的 Webview 面板。一个重要前提扩展不包含 Sapling 本体README.md中有一句醒目的注意事项该扩展不包含 Sapling SCM 本身。你必须先通过 Sapling 的正常安装流程安装好 Sapling SCM确保sl命令在 PATH 中扩展才能正常工作。这一点在源码中也有印证——extension/config.ts 中的getCLICommand()会读取sapling.commandPath配置未配置时默认使用slWindows 为sl.exe扩展的所有仓库操作都通过调用这个 CLI 命令完成// addons/vscode/extension/config.ts export function getCLICommand(): string { return ( vscode.workspace.getConfiguration(sapling).get(commandPath) || (os.platform() win32 ? sl.exe : sl) ); }二、安装与前置条件1. 安装 Sapling SCM在安装扩展之前请先完成 Sapling SCM 本体的安装并确认sl --version可以正常执行。安装完成后将包含sl的目录加入系统 PATH。2. 安装扩展从 VS Code 扩展市场搜索 Sapling SCM发布者为 meta即可安装。从仓库 addons/vscode/package.json 可以看到当前版本的元数据字段值namesapling-scmversion0.1.71publishermetalicenseMITengines.vscode^1.86.0要求 VS Code 1.86 及以上categoriesSCM Providers扩展的激活事件activationEvents包括onStartupFinished、onCommand:sapling.open-isl、onWebviewPanel:sapling.isl、onView:sapling.isl这意味着扩展会在 VS Code 启动完成后或首次需要它时自动激活无需手动干预。三、启动 Interactive Smartlog 的两种方式README.md明确给出了两种启动 ISL 的途径方式一通过命令面板在 VS Code 中打开命令面板CtrlShiftP/CmdShiftP运行Sapling SCM: Open Interactive Smartlog命令。该命令在 package.json 中注册为sapling.open-isl其实际处理逻辑位于 islWebviewPanel.ts 的registerISLCommands中。方式二自定义键盘快捷键如果你更喜欢键盘操作可以在 VS Code 的keybindings.json中为sapling.open-isl命令绑定自己的快捷键{ key: ctrlalts, command: sapling.open-isl }值得一提的是扩展本身也内置了默认快捷键绑定见 package.json 的keybindings段sapling.open-islCtrlShiftImacOS 为CmdShiftI但仅当isl.openInteractiveSmartlogShortcutEnabled上下文为真时生效sapling.open-comparison-view-uncommittedCtrlmacOSCmdsapling.open-comparison-view-headCtrlShiftmacOSCmdShiftsapling.open-commentsAltShiftGsapling.toggle-inline-commentsAltShiftT。更多入口除了 README 提到的两种方式从 package.json 的contributes.menus可以看到 ISL 还有更多触发入口SCM 标题栏按钮当scmProvider sapling时SCM 面板标题栏会出现打开 ISL 的入口编辑器标题栏按钮配置sapling.isl.showOpenOrFocusButtonOnEditorTitle为true默认开启时活动编辑器标题栏会显示打开/聚焦 ISL 的按钮活动栏/侧边栏视图配置sapling.isl.showInSidebar为true后ISL 会作为侧边栏 Webview 视图常驻视图 id 为sapling.isl。四、原理剖析Webview ISL 与sl web的关系README 强调扩展的 ISL UI as you would get by runningsl web。理解这一点的实现机制有助于你更好地使用和调试扩展。1. Webview 的创建与复用islWebviewPanel.ts 中的createOrFocusISLWebview()负责创建或聚焦 ISL 面板如果 ISL 面板已存在则直接reveal()复用并通过changeActiveRepo消息切换到指定仓库的 cwd工作目录否则调用vscode.window.createWebviewPanel(sapling.isl, ...)创建一个新的 Webview 面板标题为 Interactive Smartlog。整个 VS Code 扩展进程内只维护一个共享的 ISL Webview模块级变量islPanelOrViewResult切换仓库时通过消息通知前端重定向而不是为每个仓库各开一个面板。2. Webview HTML 与安全策略htmlForWebview.ts 负责生成 Webview 的 HTML生产模式同步写入带严格 Content-Security-PolicyCSP的 HTML所有脚本通过nonce白名单放行script-src还允许wasm-unsafe-evalISL 依赖 WASM 模块开发模式NODE_ENVdevelopment时先从本地 Vite dev serverhttp://localhost:3015见devPort常量拉取实时编译的 HTML再注入自定义样式与初始脚本兼容性样式自动继承 VS Code 编辑器的editor.fontLigatures与editor.tabSize配置让 ISL 内嵌代码区域与编辑器观感一致。3. 前端与后端的消息通信ISL Webview 与 Sapling 后端之间通过postMessage双向通信后端到前端panelOrView.webview.postMessage(message)前端到后端通过onDidReceiveMessage监听消息序列化使用 ISL 共享模块的serializeToString/deserializeFromString见 addons/isl/src/serialize.ts。连接建立后onClientConnection会注入仓库上下文cwd、command、platform、version等ISL 前端据此向sl命令发起操作请求。4. 状态持久化ISL 的 UI 状态如筛选条件、展开的提交保存在 VS Code 的globalState中。getInitialStateJs会把持久化状态以 JSON 形式注入 Webview HTMLkey 前缀为isl-persisted:实现启动时的同步恢复同时包含旧版单一 key 存储isl-persisted到逐 key 存储的迁移逻辑。五、配置项详解扩展在 VS Code 设置中以sapling.*前缀暴露全部配置声明于 package.json 的contributes.configuration中文说明对应 package.nls.json。下表列出全部配置项及其默认值配置项类型默认值说明sapling.commandPathstring指定用于运行 Sapling 命令的可执行文件路径留空则使用 PATH 中的slWindows 为sl.exe。修改后需重启 VS Code 生效sapling.showInlineBlamebooleantrue浏览 Sapling 仓库文件时在光标附近显示行内 blame 标注sapling.showDiffCommentsbooleantrue是否显示代码评审Phabricator Diff评论与行内代码建议sapling.inlineCommentDiffViewModeenumUnified代码建议以统一视图还是分割视图呈现Unified/Splitsapling.markConflictingFilesResolvedOnSavebooleantrue保存文件后若文件中已无冲突标记则自动将该文件标记为冲突已解决sapling.comparisonPanelModeenumAlways Separate Panel比较视图的展示方式AutoISL 激活时在 ISL 内展示否则用 VS Code 原生 multi-diff 编辑器/Always Separate Panel始终使用原生 multi-diff 编辑器sapling.isl.openBesidebooleanfalse为true时文件、diff 与比较视图将打开在 ISL 面板旁边ViewColumn.Beside而非同一列便于点击文件时 ISL 保持可见sapling.isl.showInSidebarbooleanfalse为true时 ISL 以侧边栏视图呈现为false时以普通编辑器面板呈现。修改后需重启完全生效sapling.isl.showOpenOrFocusButtonOnEditorTitlebooleantrue在活动编辑器标题/标签栏显示打开或聚焦 ISL按钮sapling.isl.showInlineSignalsenumall控制编辑器中行内 diff 信号CI 结果如 lint 错误、测试失败等的显示级别all/errors warnings/errors/nonesapling.isl.inlineSignalsRenderModeenuminset行内信号渲染方式inset内嵌 Webview带丰富控件/diagnostics标准 VS Code diagnostics 与波浪线关于commandPath的实现细节如前所述config.ts 的getCLICommand()是命令行解析的核心。需要特别留意的是commandPath的修改需要重启 VS Code才能生效源码注释明确说明该值会被缓存复用如果 Sapling 可执行文件不在 PATH 中你可以把绝对路径写进commandPath例如C:\\tools\\sapling\\sl.exe或/usr/local/bin/sl。六、命令大全扩展注册的命令完整清单见 package.json 的contributes.commands按功能可分为以下几类ISL 相关命令 ID显示名称sapling.open-islOpen Interactive Smartlog (ISL)sapling.isl.focusFocus Sapling ISL Sidebarsapling.close-isl关闭 ISL 面板/侧边栏编程式调用Diff 与比较视图命令 ID显示名称sapling.open-file-diff-uncommittedOpen Diff View For Current File (Uncommitted Changes)sapling.open-file-diff-headOpen Diff View For Current File (Head Changes)sapling.open-file-diff-stackOpen Diff View For Current File (Stack Changes)sapling.open-comparison-view-uncommittedOpen Comparison Viewer (Uncommitted Changes)sapling.open-comparison-view-headOpen Comparison Viewer (Head Changes)sapling.open-comparison-view-stackOpen Comparison Viewer (Stack Changes)sapling.open-multi-diff-file-headOpen Working Copy File文件操作与远程链接命令 ID显示名称sapling.revert-fileRevert uncommitted change to this filesapling.open-remote-file-linkOpen in Code Reviewsapling.copy-remote-file-linkCopy Code Review Link代码评审评论命令 ID显示名称sapling.open-commentsOpen Code Review Comments Panelsapling.toggle-inline-commentsToggle Show/Hide Inline Code Review CommentsWorktree 操作需 EdenFS命令 ID显示名称sapling.worktree.switchSwitch Worktreesapling.worktree.addAdd Worktreesapling.worktree.removeRemove Worktreesapling.worktree.renameRename Worktree这些命令的实际实现集中在 extension/commands.ts 的vscodeCommands对象中通过registerCommands()统一注册并在执行时自动上报遥测事件RunVSCodeCommand。七、深度集成功能1. Diff 视图三种比较范围对当前文件你可以打开三种 diff 视图对应sapling.open-file-diff-*系列命令Uncommitted Changes未提交变更比较工作区与上次提交Head ChangesHEAD 变更比较当前提交与公开祖先Stack Changes栈变更比较整个提交栈。从源码看commands.ts 中的openDiffView通过vscode.diff命令打开左右两侧对比左侧before与右侧after的 revset 由 shared/Comparison.ts 的beforeRevsetForComparison/currRevsetForComparison计算。值得注意的实现细节未提交/HEAD 比较的右侧直接使用file://URI因此你可以在 diff 视图右侧直接编辑文件比较历史提交或子模块变更时右侧则使用自定义 scheme 的 URIsapling-diff此时右侧是只读内容被删除的文件通过DeletedFileContentProvider提供内容确保删除的文件也能正常参与 diff。2. 比较视图与原生 multi-diff 编辑器sapling.open-comparison-view-*系列命令会打开整个仓库层面的比较。扩展会优先尝试 VS Code 原生 multi-diff 编辑器openNativeMultiDiffEditor失败时回退到 Webview 比较面板。排序时还会调用generatedFilesDetector检测生成文件把手动文件排在前面、生成文件排到后面。3. 行内 Blame开启sapling.showInlineBlame后浏览文件时光标附近会显示行内 blame 标注。该功能由 extension/blame/blame.ts 的InlineBlameProvider实现并在 extension.ts 的activate中按 SCM API 能力开关注册默认能力集为blame与sidebar。4. 行内代码评审评论扩展支持在编辑器中显示 Phabricator Diff 的行内评论与代码建议相关命令为sapling.open-comments与sapling.toggle-inline-comments。评论面板作为 SCM 区域的 Webview 视图idsapling.comments提供。行内建议的 diff 视图模式由sapling.inlineCommentDiffViewMode控制。5. Worktree 管理sapling.worktree.*系列命令让你在 VS Code 中直接管理 Sapling 的 worktree工作树。需要特别说明的限制从 commands.ts 的resolveWorktreeRepo可以看出仅支持 EdenFS 仓库非 EdenFS 仓库会提示 Worktrees require EdenFSGitHub 代码评审类型的仓库不支持 worktree。八、扩展架构与启动流程从 extension/extension.ts 的activate入口可以看到完整的装配流程activate() ├── 创建输出通道日志Sapling ISL Output Channel ├── 初始化平台抽象vscodePlatform ├── 构造 RepositoryContextcmd / cwd / logger / tracker ├── 加载翻译i18n并查询启用的 SCM API 特性 ├── registerISLCommands()注册 ISL Webview 面板/视图与相关命令 ├── VSCodeReposList管理当前工作区内的 Sapling 仓库 ├── InlineBlameProvider行内 blame ├── registerSaplingDiffContentProvider / DeletedFileContentProviderdiff 内容提供者 ├── registerCommands()注册其余命令 └── makeExtensionApi()暴露扩展 API几个关键设计仓库缓存repositoryCacheisl-server/src/RepositoryCache.ts按路径缓存Repository实例避免重复初始化平台抽象vscodePlatform.ts实现了ServerPlatform接口把 ISL 前端发来的platform/openFiles等平台消息翻译为 VS Code 的打开文件、跳转行号等操作孤儿面板恢复当扩展宿主extension host重启而 ISL 面板仍存在时replaceExistingOrphanedISLWindows会检测失效的 ISL 标签页并在原位置重建这是对 VS Code 已知行为——Webview 面板序列化不生效——的补偿源码注释引用了 microsoft/vscode issue 188257。九、开发与构建如果你希望从源码构建或调试该扩展package.json 提供了完整的脚本脚本作用yarn watch-extension以 watch 模式构建扩展主进程rolldownyarn watch-webview以 watch 模式启动 Webview 的 Vite dev server端口 3015yarn build-extension生产构建扩展主进程yarn build-webview生产构建 Webview 前端yarn test运行 Jest 测试覆盖 extension/tests下的命令、Webview 面板、平台适配等yarn lintoxlint 静态检查开发模式下Webview 会从http://localhost:3015实时加载 Vite 编译产物并自动注入 VS Code 兼容样式实现前端热更新调试。十、版本演进与使用建议从 CHANGELOG.md 可以追踪扩展的演进脉络近期版本持续优化了提交图过滤的输入防抖、CI 信号徽章批量查询、生成文件排序、worktree 命令面板入口等。早期版本还引入了 absorb将未提交变更分发进提交栈等特性。实际使用中请记住几个容易踩坑的点扩展 ≠ Sapling 本体先装好 Sapling SCM确认sl可用否则扩展无法工作commandPath与showInSidebar修改后需重启这两个配置在激活早期即被读取并缓存ISL 面板全局唯一扩展复用同一个 ISL Webview多仓库场景下通过 cwd 切换而不是打开多个面板worktree 功能有前置约束需要 EdenFS 且代码评审系统非 GitHub。掌握以上内容后你就可以把 VS Code 当作 Sapling 的完整操作台用CtrlShiftI唤起 ISL在编辑器内完成提交、栈管理、比较与代码评审的全部日常工作。赞分享开发工具CLI后端【免费下载链接】saplingA Scalable, User-Friendly Source Control System.项目地址https://gitcode.com/gh_mirrors/sa/sapling点击查看免费下载相关推荐Sapling SCM VS Code扩展在IDE中无缝管理代码版本的完整指南Sapling SCM VS Code扩展在IDE中无缝管理代码版本的完整指南 Sapling SCM VS Code扩展是开发者在IDE中高效管理代码版本的开发工具CLI后端PRQL × Visual Studio Code在编辑器内实时编译 PRQL 查询为 SQL 的官方扩展实战指南PRQL × Visual Studio Code在编辑器内实时编译 PRQL 查询为 SQL 的官方扩展实战指南 PRQLPipelined Relati文档教程技术博客Relay 编辑器支持基于 Rust 编译器的 LSP 语言服务与 VS Code 官方扩展实战指南Relay 编辑器支持基于 Rust 编译器的 LSP 语言服务与 VS Code 官方扩展实战指南 Relay 的 Rust 编译器对代码中嵌入的 Grap前端开发工具上一篇3 分钟跑通 awesome-claude-codeClaude Code 精选资源大全维护指南下一篇TypeScript 接口合并与扩展Merging and Extension声明合并、继承与交叉类型完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考