在银河麒麟系统中安装vs code需先确认v10 sp2+版本及x86_64/arm64架构,再依联网情况选apt源、.deb包或tar.gz方式安装;装后必须补gui依赖、配中文字体、建.desktop启动器,否则白屏、乱码或无法启动。

在银河麒麟系统中安装并使用VS Code编辑器,需先确认系统版本(如V10 SP2+)与CPU架构(x86_64或ARM64),再选择匹配的安装方式——APT源安装适合联网桌面环境,.deb包安装可绕过源配置问题,tar.gz解压部署则无需root权限;装完后必须补全GUI依赖、配置中文字体并创建.desktop启动器,否则将出现白屏、乱码或无法从应用菜单启动。
确认系统信息与架构
打开终端,依次执行以下命令:
【必须执行】cat /etc/os-release 查看系统版本,重点确认 VERSION_ID="V10" 及是否含 SP2 字样;
uname -m 输出结果决定安装包类型:若为 x86_64,选 amd64 版;若为 aarch64 或 arm64,【必须选ARM64构建版】,否则启动时会报“无法执行二进制文件”;
echo $XDG_CURRENT_DESKTOP 确认桌面环境(如 UKUI),后续创建桌面图标需适配该环境。
APT源安装(推荐用于Kylin V10 SP2+联网桌面)
该方式支持自动依赖解析与后续升级,但要求网络通畅且已配置可用软件源。
第一步:更新系统并安装基础工具
sudo apt update && sudo apt upgrade -y && sudo apt install -y wget gnupg2 software-properties-common apt-transport-https
第二步:导入Microsoft官方GPG密钥
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -o root -g root -m 644 packages.microsoft.gpg /usr/share/keyrings/
第三步:添加VS Code专属源
sudo sh -c 'echo "deb [arch=amd64 signed-by=/usr/share/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list'
第四步:安装VS Code
sudo apt update && sudo apt install code -y
.deb包手动安装(离线或源失效时首选)
方法一:直接下载安装(仅适用于x86_64架构)
wget https://update.code.visualstudio.com/latest/linux-deb-x64/stable -O vscode.deb
sudo dpkg -i vscode.deb
sudo apt --fix-broken install -y
方法二:ARM64架构专用流程
先确认 uname -m 输出为 aarch64 或 arm64,再执行:
wget https://update.code.visualstudio.com/latest/linux-deb-arm64/stable -O vscode-arm64.deb
sudo dpkg -i vscode-arm64.deb
sudo apt --fix-broken install -y
【关键提醒】若 dpkg 提示 “architecture mismatch”,说明你下了 x86_64 包却跑在 ARM 机器上,必须换包重装。
tar.gz解压部署(无sudo权限时使用)
这一步操作起来很简单,直接把压缩包解压到用户目录就行。
下载稳定版压缩包:
wget https://update.code.visualstudio.com/latest/linux-x64/stable -O vscode.tar.gz
解压至 ~/opt/vscode:
mkdir -p ~/opt && tar -xf vscode.tar.gz -C ~/opt/vscode --strip-components=1
赋予执行权限:
chmod +x ~/opt/vscode/Code
创建软链接便于终端调用:
ln -sf ~/opt/vscode/Code ~/.local/bin/code
安装后必备配置
启动VS Code前,必须补全GUI依赖,否则大概率白屏或崩溃:
sudo apt install -y libgtk-3-0 libxss1 libasound2 libgbm1
设置中文界面:
按 Ctrl+Shift+P → 输入 Configure Display Language → 选择 zh-cn → 重启窗口
修复中文字体乱码:
sudo apt install -y fonts-wqy-microhei fonts-wqy-zenhei
创建UKUI桌面图标:
mkdir -p ~/.local/share/applications
用文本编辑器新建 ~/.local/share/applications/vscode.desktop,填入以下内容:
[Desktop Entry]
Name=Visual Studio Code
Exec=/usr/bin/code --no-sandbox %F
Icon=vscode
Type=Application
Categories=Development;IDE;
StartupNotify=true
Terminal=false
MimeType=text/plain;inode/directory;
最后执行:
update-desktop-database ~/.local/share/applications











