2025最新VSCodium安装教程：Windows、macOS与Linux全平台部署指南
项目地址: https://gitcode.com/gh_mirrors/vs/vscodium 你是否还在为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. 手动安装包
访问项目发布页面下载对应版本：
支持的安装包格式：
- 可执行安装程序：
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安装
- 从发布页面下载最新DMG文件：VSCodium macOS Releases
- 挂载镜像后将VSCodium拖入Applications文件夹
- 首次启动按住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
验证安装
成功安装后，可通过以下方式验证：
- 启动VSCodium，检查欢迎界面是否显示"VSCodium"标识
- 打开命令面板（Ctrl+Shift+P或Cmd+Shift+P）
- 输入
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"扩展，重启后生效。
下一步
安装完成后，推荐进行以下配置：
- 导入VS Code设置：
File > Preferences > Import Settings - 安装必要扩展：docs/extensions-compatibility.md
- 配置Git集成：docs/accounts-authentication.md
VSCodium项目源码：https://link.gitcode.com/i/0b4a029617ec9a9aafa472c047d1c546
问题反馈：提交issue
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
