必须按系统架构和运行时环境选安装方式:uname -m确认arm64或x86_64,cat /etc/os-release核对kylin v10 sp2+或uos 20/23,echo $xdg_session_type判断wayland以启用electron_ozone_platform。

code 在银河麒麟(Kylin V10 SP2+)和统信UOS(20/23系列)上能跑,但**不能直接装软件中心里的版本**——它大概率是旧版、未适配ARM64、缺关键依赖,启动白屏或中文输入崩溃是常态。
必须按系统实际架构和运行时环境选安装路径,跳过默认“一键安装”陷阱。
怎么确认该用哪种安装方式?
先打开终端,三行命令摸清底细:
-
uname -m—— 输出aarch64就是 ARM64(飞腾、鲲鹏、昇腾),输出x86_64是 AMD/Intel -
cat /etc/os-release | grep -E "(VERSION_CODENAME|PRETTY_NAME)"—— 看是不是 Kylin V10 SP2+ 或 UOS 20/23,老版本(如 Kylin V10 SP1)glibc 2.32 不满足 VSCode 2026 的2.34+要求,得降级或打补丁 -
echo $XDG_SESSION_TYPE—— 输出wayland表示用的是 Wayland 显示协议,必须设ELECTRON_OZONE_PLATFORM=wayland,否则 GPU 渲染失败
APT源安装:适合联网+长期更新的开发机
这是最省心的方式,但必须显式声明双架构,否则 ARM64 机器会装错包。
本文档主要讲述的是Android 操作系统的介绍;Android是基于Linux内核的操作系统,是Google公司在2007年11月5日公布的手机操作系统,早期由Google开发,后由开放手持设备联盟(Open Handset Alliance)开发。它采用了软件堆层(software stack,又名以软件叠层)的架构,主要分为三部分。底层Linux内核只提供基本功能;其他的应用软件则由各公司自行开发,部分程序以Java编写。希望本文档会给有需要的朋友带来帮助;感兴趣的朋友可以过来看看
- 导入密钥时用
/usr/share/keyrings/packages.microsoft.gpg,不是旧路径/etc/apt/trusted.gpg.d/,否则apt update报 GPG error - 源地址里必须带
[arch=amd64,arm64],漏掉arm64会导致sudo apt install code拉到 x86_64 包,在鲲鹏上直接exec format error - 装完首次启动前,先执行:
export ELECTRON_OZONE_PLATFORM=wayland && export LIBGL_ALWAYS_SOFTWARE=1,避免 EGL 初始化失败黑屏
.deb 手动安装:离线/ARM64/锁定版本必选
适用于无外网、国产芯片专用设备,或需要验证特定构建版本(比如适配龙芯3A6000的 RISC-V64 版)。
- 下载链接必须匹配架构:
linux-deb-arm64对应aarch64,linux-deb-x64对应x86_64;混用会安装成功但运行时报cannot execute binary file: Exec format error -
dpkg -i前务必预装依赖:libx11-xcb1、libasound2、libgbm1、libxkbfile1、libxrandr2、libsecret-1-0;缺libsecret-1-0会导致登录 GitHub 时弹窗卡死 - 装完别急着点图标启动——先终端运行
code --verbose,看到FATAL: libglib-2.0.so.0: cannot open shared object file就说明 glib 版本低,需手动升级或加--no-sandbox
启动后必做的三件事
装完只是开始,不配置就等于没装。
- 语言包必须手动装:VSCode 启动后按
Ctrl+Shift+P,输Configure Display Language,选zh-cn,重启;官方汉化扩展(Chinese (Simplified) Language Pack)要单独装,否则菜单仍是英文 - 终端默认 Shell 改成
/bin/bash:设置里搜terminal.integrated.defaultProfile.linux,值设为"bash",否则 UOS 自带的ukui-terminal可能调不起zsh或报Failed to launch terminal - 中文输入法崩溃?不是 fcitx5 问题,是 Electron 沙箱符号劫持。临时解法:右键桌面图标 → 属性 → 启动命令末尾加
--no-sandbox;长期解法需重绑定libibus-1.0.so符号,涉及内核模块 patch,普通用户建议优先用--no-sandbox










