vscode --install-extension 报 command not found 的根本原因是国产系统（如统信uos、麒麟v10）默认未安装 code 命令的 shell 集成，需手动执行“shell command: install 'code' command in path”并重启终端；arm64架构下还需确保插件为 linux-arm64 版本且 glibc/openssl 兼容。
vscode --install-extension 在国产系统上为什么报错 command not found
不是 PATH 没配，而是多数国产系统（如统信UOS、麒麟V10）默认没装 code 命令的 Shell 集成。VSCode 安装器不会自动注册它，尤其在非 root 权限安装或 .zip 免安装版下。
必须手动触发注册：打开 VSCode → Ctrl+Shift+P → 输入 Shell Command: Install 'code' command in PATH → 回车执行。执行后重启终端，code --version 能输出即成功。
常见坑：
- 用 root 安装 System Installer 后，普通用户终端仍找不到
code，需切换到对应用户再执行一次注册命令 - 某些国产系统（如深度Deepin 23）的终端启动时未重载
~/.profile，执行完注册后要新开终端，不能只source ~/.bashrc - .zip 版本必须先运行一次
Code.exe（Linux/macOS 是./Code），否则注册命令不可见
拖拽 .vsix 失败？重点检查文件系统和桌面环境兼容性
国产系统桌面环境（如 UKUI、Cinnamon、DDE）对拖放事件拦截更严格，尤其是全屏状态、远程桌面（如 VNC 连接统信UOS）或 Wayland 会话下，VSCode 根本收不到文件路径。
绕过方式只有两个：
- 改用命令行安装：
code --install-extension /home/user/Downloads/python.vsix（路径必须是绝对路径，且不能含中文或空格） - 切到 X11 会话：登录界面右下角选 “Ubuntu on Xorg” 类似选项（UOS/麒麟通常标为 “兼容模式” 或 “传统桌面”）
另外注意：部分国产系统挂载 U 盘默认用 vfat 文件系统，会丢弃 .vsix 文件的可执行位和校验信息。拷贝前先在 Windows/macOS 上用 unzip -t python.vsix 验证，再传入国产系统。
ARM64 架构适配：飞腾/鲲鹏机器装插件必须盯紧 darwin-arm64 和 linux-arm64
国产 CPU（飞腾 D2000、鲲鹏 920）基本是 ARM64，但 VSCode 插件市场默认推送的是 linux-x64 构建包——这类包里若含 native 二进制（如 pyright-server、volar-server），直接静默失败，不报错，只表现为“Python 语法不提示”“Vue 模板无补全”。
验证方法：
- 解压
.vsix，打开extension/package.json，搜索"engines"和"cpu"字段；含"cpu": ["arm64"]或"os": ["linux"]+"cpu": ["arm64"]才可信 - 优先从插件 GitHub Release 页面下载，过滤关键词：
linux-arm64（不是linux-x64）、darwin-arm64（Mac M 系列） - 避坑：不要用
vsce download默认拉取，它不识别架构，得加--platform linux-arm64
语言服务器（LSP）离线启动失败的真正原因
插件显示“已启用”，但 Python/Vue/TypeScript 功能全失效——90% 是 LSP 二进制没落地，不是插件本身问题。国产系统上还有额外一层：glibc 版本不兼容。
比如麒麟 V10 SP1 默认 glibc 2.28，而某些插件打包的 pyright-server 编译于 glibc 2.31+，运行时报 GLIBC_2.31 not found，但 VSCode 只在 Output → Python 面板里写一行错误，不弹窗。
解决路径：
- 先看 Output 面板，筛选关键字：
spawn ENOENT（文件不存在）、GLIBC（ABI 不兼容）、Permission denied（国产系统 SELinux/AppArmor 限制） - 在有网机器上完整触发 LSP 下载（开一个
.py文件，等状态栏变Ready），然后整个拷~/.vscode/extensions/ms-python.python-2024.6.0/目录，不是只拷.vsix - 拷完删掉目标机
~/.vscode/extensions/*/node_modules下所有*-server的软链接，改用绝对路径指向真实二进制（国产系统对相对路径解析更敏感）
最易被忽略的一点：国产系统常预装旧版 OpenSSL，而新 LSP 二进制依赖 OpenSSL 3.x。不报错，但 TLS 握手失败导致无法连接本地 server —— 得手动替换 libssl.so.3 或降级插件版本。
