2025最新VSCodium安装教程：Windows、macOS与Linux全平台部署指南

你是否还在为Visual Studio Code的许可限制和数据收集感到困扰？VSCodium作为VS Code的开源替代方案，提供了无微软品牌、无遥测跟踪的纯净体验。本文将带你通过三种主流操作系统的官方推荐方式，快速部署VSCodium开发环境，5分钟即可完成从下载到启动的全流程。

关于VSCodium

VSCodium并非VS Code的分支，而是通过构建脚本生成的开源二进制版本。项目移除了微软专有组件和遥测功能，保留了完整的代码编辑体验，所有二进制文件均基于MIT协议开源分发。

官方文档：docs/getting-started.md
项目许可证：LICENSE

Windows系统安装方案

Windows用户可根据偏好选择以下四种官方推荐安装方式，所有方法均支持自动更新：

1. WinGet命令行安装（推荐）

适用于Windows 10/11 20H2及以上版本，通过系统内置包管理器一键部署：

winget install -e --id VSCodium.VSCodium

如需尝鲜开发版：

winget install -e --id VSCodium.VSCodium.Insiders

2. Chocolatey包管理安装

已安装Chocolatey的用户可执行：

choco install vscodium

开发版安装命令：

choco install vscodium-insiders

3. Scoop安装

Scoop用户需先添加额外仓库：

scoop bucket add extras
scoop install vscodium

4. 手动安装包

访问项目发布页面下载对应版本：

• 稳定版：VSCodium Releases
• 开发版：VSCodium Insiders

支持的安装包格式：

• 可执行安装程序：VSCodiumSetup-x64-*.exe
• 无安装版zip包：VSCodium-win32-x64-*.zip
• MSI安装包：VSCodium-x64-*.msi

macOS系统安装方案

macOS提供两种原生安装方式，均通过官方验证渠道分发：

1. Homebrew Cask安装（推荐）

已安装Homebrew的用户执行：

brew install --cask vscodium

开发版安装命令：

brew install --cask vscodium@insiders

2. 手动DMG安装

1. 从发布页面下载最新DMG文件：VSCodium macOS Releases
2. 挂载镜像后将VSCodium拖入Applications文件夹
3. 首次启动按住Control键点击图标，选择"打开"以绕过 Gatekeeper验证

支持的硬件架构：

• Intel芯片：x64架构安装包
• Apple芯片：arm64原生支持包

Linux系统安装方案

Linux提供多种包管理器支持，涵盖主流发行版：

1. Snap商店安装（通用）

支持所有已安装snapd的系统（Ubuntu/Debian/Fedora等）：

snap install codium --classic

Snap包由Snapcrafters社区维护，自动处理依赖关系和沙箱隔离

2. 包管理器仓库（推荐）

由社区维护的专用仓库支持APT/DNF/Zypper：

Debian/Ubuntu系：

# 添加GPG密钥
wget -qO - https://gitlab.com/paulcarroty/vscodium-deb-rpm-repo/-/raw/master/pub.gpg | gpg --dearmor | sudo dd of=/usr/share/keyrings/vscodium-archive-keyring.gpg
# 添加仓库
echo 'deb [ signed-by=/usr/share/keyrings/vscodium-archive-keyring.gpg ] https://download.vscodium.com/debs vscodium main' | sudo tee /etc/apt/sources.list.d/vscodium.list
# 安装
sudo apt update && sudo apt install codium

Fedora/RHEL系：

sudo dnf config-manager --add-repo https://download.vscodium.com/rpms/vscodium.repo
sudo dnf install codium

3. Arch Linux AUR安装

Arch用户可通过AUR获取最新版本：

yay -S vscodium-bin  # 稳定版
# 或开发版
yay -S vscodium-insiders-bin

4. Flatpak安装

已配置Flathub仓库的系统：

flatpak install flathub com.vscodium.codium
flatpak run com.vscodium.codium

验证安装

成功安装后，可通过以下方式验证：

1. 启动VSCodium，检查欢迎界面是否显示"VSCodium"标识
2. 打开命令面板（Ctrl+Shift+P或Cmd+Shift+P）
3. 输入About VSCodium，确认版本号与安装包匹配

常见问题解决

扩展市场访问

VSCodium默认使用开源扩展市场Open VSX，如需访问VS Code市场，可通过修改配置启用：

{
  "extensions.marketplaceUrl": "https://marketplace.visualstudio.com/_apis/public/gallery"
}

详细说明：docs/extensions.md

权限问题

Linux系统如遇文件访问权限错误，检查安装目录权限：

sudo chown -R $USER:$USER ~/.vscode-oss

中文显示异常

通过命令面板安装"Chinese (Simplified) Language Pack"扩展，重启后生效。

下一步

安装完成后，推荐进行以下配置：

1. 导入VS Code设置：File > Preferences > Import Settings
2. 安装必要扩展：docs/extensions-compatibility.md
3. 配置Git集成：docs/accounts-authentication.md

VSCodium项目源码：https://gitcode.com/gh_mirrors/vs/vscodium
问题反馈：提交issue