VSCodium 迁移指南从 Visual Studio Code 平滑迁移扩展、设置与键位配置【免费下载链接】vscodiumbinary releases of VS Code without MS branding/telemetry/licensing项目地址: https://gitcode.com/gh_mirrors/vs/vscodium本文围绕 VSCodium 官方文档 docs/migration.md 的完整内容展开系统讲解从 Visual Studio Code 迁移到 VSCodium 的两种主流方案手动复制用户数据目录以及借助 Sync Settings 扩展实现半自动同步。VSCodium 是使用社区默认配置构建的 VS Code 自由开源二进制发行版其构建脚本与补丁见仓库根目录二者共享同一套代码基座但用户数据存储路径完全不同因此迁移的核心就是处理好扩展目录与用户配置文件两大块。读完本文你将能独立完成扩展、设置、键位绑定乃至整机开发环境的迁移并掌握迁移后的扩展市场与用户级 product.json 配置技巧。迁移背景为什么从 VS Code 迁移需要专门处理VSCodium 由仓库中的自动化脚本基于微软 [vscode] 源码构建产物去除了微软品牌标识、遥测与许可限制参见 README.md 的项目定位说明。尽管编辑器内核一致但 VSCodium 使用与 Visual Studio Code 不同的应用标识如 macOS 上的com.vscodium导致两者的用户数据目录彼此独立、互不共享Visual Studio Code 的扩展存放在~/.vscode/extensionsVSCodium以及从源码全新克隆构建的 vscode扩展存放在~/.vscode-oss/extensions。这意味着安装 VSCodium 后原有扩展不会自动出现。同样settings.json、keybindings.json等配置文件也分别存放在各自的用户设置目录中需要显式复制或同步。下文两条迁移路径正是围绕这些差异展开。迁移前的准备两份路径对照表在动手之前先明确 Visual Studio Code 与 VSCodium 在三个主流平台上的用户设置目录来源docs/migration.md。Visual Studio Code 的keybindings.json与settings.json存放位置平台路径Windows%APPDATA%\Code\UsermacOS$HOME/Library/Application Support/Code/UserLinux$HOME/.config/Code/UserVSCodium 对应的用户设置目录平台路径Windows%APPDATA%\VSCodium\UsermacOS$HOME/Library/Application Support/VSCodium/UserLinux$HOME/.config/VSCodium/User从源码结构与官方补丁看VSCodium 的用户数据根目录user data path由 product 配置中的nameShort决定例如getUserDataPath({_:[]}, product.nameShort ?? code-oss-dev)见 patches/00-settings-user-product.patch 对src/cli.ts的修改。这就是为什么 Linux 上 VSCodium 使用~/.config/VSCodium而 VS Code 使用~/.config/Code——两者是同一套环境路径逻辑下不同应用名产生的不同目录。迁移时只需把源目录内容搬入目标目录无需改动目录结构。方案一手动迁移复制扩展与配置文件手动迁移适合一次性、明确可控的迁移场景全程不依赖第三方扩展。1. 迁移扩展目录将 Visual Studio Code 的扩展目录整体复制到 VSCodium 的扩展目录# Linux / macOS cp -r ~/.vscode/extensions ~/.vscode-oss/extensions # WindowsPowerShell Copy-Item -Recurse $env:USERPROFILE\.vscode\extensions $env:USERPROFILE\.vscode-oss\extensions复制完成后建议重启 VSCodium让扩展宿主进程重新加载扩展清单。需要说明的是少数微软出品的专有扩展如 C/C、Python、Live Share、Remote 系列因其授权限制与内置校验并不兼容 VSCodium具体不兼容清单与社区推荐替代品可参考 docs/extensions-compatibility.md这部分不属于复制能解决的问题迁移后可按需选用 clangd、BasedPyright、Open Remote - SSH 等替代方案。2. 迁移设置与键位绑定官方文档给出的手动复制设置步骤如下在 Visual Studio Code 中打开设置快捷键Meta,macOS 的 Meta 即 Command 键Windows/Linux 对应Ctrl,点击设置页右上角的三个点...选择Open settings.json复制settings.json的全部内容粘贴到 VSCodium 的同一位置即上文 VSCodium 用户设置目录下的settings.json并保存。keybindings.json的迁移同理直接复制 VS Code 用户设置目录中的keybindings.json到 VSCodium 对应目录即可。若你希望保留全部用户级数据如代码片段snippets、工作区存储workspaceStorage等也可以直接对两个User 目录做整体复制但注意 VSCodium 的目录名与 VS Code 不同VSCodiumvsCode切勿覆盖错目标。3. 迁移后的补充用户级 product.json迁移完常规配置后很多用户会发现 VSCodium 默认使用 Open VSX 扩展市场部分扩展在 Open VSX 上缺失。VSCodium 提供了一条无需重新编译的配置通道在用户数据目录下放置自定义product.json应用启动时会将其与内置产品配置深度合并。该机制由补丁 patches/00-settings-user-product.patch 实现src/cli.ts与src/main.ts在启动阶段通过resolveUserProduct()读取用户数据目录下的product.json并挂载到全局变量_VSCODE_USER_PRODUCT_JSON随后src/vs/platform/product/common/product.ts中新增的merge逻辑递归合并数组与嵌套对象。配置文件存放位置来自 docs/extensions.mdWindows%APPDATA%\VSCodium或%USERPROFILE%\AppData\Roaming\VSCodiummacOS~/Library/Application Support/VSCodiumLinux$XDG_CONFIG_HOME/VSCodium或~/.config/VSCodium典型用途是切换扩展市场例如{ extensionsGallery: { serviceUrl: , // 必填 itemUrl: , // 必填 extensionUrlTemplate: // 必填 } }也可以不写文件直接用环境变量VSCODE_GALLERY_SERVICE_URL、VSCODE_GALLERY_ITEM_URL、VSCODE_GALLERY_EXTENSION_URL_TEMPLATE覆盖详见 docs/extensions.md。注意Insiders 版本对应的目录名是VSCodium - Insiders。方案二半自动迁移Sync Settings 扩展如果希望在 VS Code 与 VSCodium 之间持续保持配置一致设置、键位、扩展等官方文档推荐使用Sync Settings扩展。该扩展的作者同时也是 VSCodium 的主要维护者项目定位与 VSCodium 高度契合。扩展可在 Visual Studio Marketplace、Open VSX 或扩展的源码仓库中获取安装。工作原理Sync Settings 以 Git 仓库或兼容 Git 的远程仓库为同步中枢将本地用户配置上传到仓库再从仓库下载到其他机器/应用。由于 VSCodium 与 VS Code 共享同一套 vscode 配置格式这套机制可以在两个应用之间无缝中转。相比手写脚本它还能同步扩展清单下载端会自动补齐缺失扩展。操作步骤安装扩展在 Visual Studio Code 与 VSCodium 中都安装 Sync Settings 扩展。配置扩展两端各执行一次打开命令面板MetaShiftPWindows/Linux 为CtrlShiftP搜索并执行Sync Settings: Open the repository settings按提示配置同步仓库如仓库地址与分支。从 VS Code 导出配置打开命令面板MetaShiftP搜索并执行Sync Settings: Upload (user - repository)将当前用户配置推送到仓库。在 VSCodium 导入配置官方建议开启syncSettings.openOutputOnActivity: true便于在 Output 面板实时观察同步日志打开命令面板MetaShiftP搜索并执行Sync Settings: Download (repository - user)务必等待全部扩展下载并安装完成在 Output 面板中跟进日志后再重启 VSCodium避免扩展未就绪导致首次启动异常。通过这套流程所有受支持的配置设置、键位绑定、扩展列表、代码片段等都会被完整迁移后续在任一端修改配置后再次执行 Upload/Download 即可持续同步。迁移后的环境校验与常见问题完成迁移后建议按以下顺序做一轮体检确保环境真正接续上扩展可用性打开扩展视图确认关键扩展已出现在 VSCodium 中且未报错对专有扩展如 Python、C/C、Remote 系列对照 docs/extensions-compatibility.md 安装社区替代品。账户登录VSCodium 中的 GitHub 登录基于 Personal Access Token 而非 OAuth 网页流按 docs/usage.md 中的说明创建 token 并依据扩展需求选择 scope例如 GitLens 需要reposcopeLinux 上如遇 keychain 报错需要安装gnome-keyring包。便携模式若你原本使用 VS Code 的 portable 模式注意 VSCodium 在 macOS 上识别的是名为codium-portable-data的特殊文件夹VS Code 为code-portable-dataWindows/Linux 上的 portable 模式操作与 VS Code 文档一致见 docs/usage.md。默认设置差异VSCodium 默认关闭遥测并移除微软品牌信息参见 patches/00-telemetry-disable.patch 与 patches/00-brand-remove-branding.patch 等构建补丁迁移过来的设置中若存在与遥测、更新相关的键值可按需确认是否仍然适用。小结从 Visual Studio Code 迁移到 VSCodium 的本质是用户数据目录换名扩展从~/.vscode/extensions迁到~/.vscode-oss/extensions设置与键位从Code/User迁到VSCodium/User。手动复制适用于一次性迁移而 Sync Settings 扩展由 VSCodium 维护者开发则能实现两端配置的持续双向同步。迁移完成后结合用户级product.json与 Open VSX 市场配置详见 docs/extensions.md即可获得一套与原有开发习惯无缝衔接、且无遥测与品牌捆绑的编辑环境。【免费下载链接】vscodiumbinary releases of VS Code without MS branding/telemetry/licensing项目地址: https://gitcode.com/gh_mirrors/vs/vscodium创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考