必须通过命令验证设备为ARM64架构：macOS需uname -m输出arm64，Linux需aarch64，Windows需systeminfo显示ARM64；安装后须确认VSCode进程、Node.js运行时、终端Shell、工具链及扩展均为arm64。
确认你的设备确实是 ARM64 架构
很多人卡在第一步：以为自己是 ARM 设备，结果 uname -m 输出却是 x86_64。ARM64（也叫 aarch64）不是靠“M1/M2”或“Jetson”这些名字判断的，而是靠命令实锤。
- macOS：打开终端，运行
uname -m，输出arm64才算数；若为x86_64，说明你正跑在 Rosetta 下，不是原生 ARM 环境 - Linux（Ubuntu/Debian/Jetson）：同样执行
uname -m，必须是aarch64；armv7l或armv8l不行，VSCode 官方不提供 armv7 支持 - Windows on ARM：运行
systeminfo，看“系统类型”是否含“ARM64”；x64 版本 VSCode 在此环境下会直接报错“不支持的处理器架构”
选对安装方式：APT / DEB / Snap / 官网原生包？
ARM64 的 Linux 发行版里，APT 是最稳的，Snap 最省事但有权限和路径限制，手动装 DEB 则容易漏依赖——三者不是平级选项，得看你的发行版和需求。
- Ubuntu/Debian 系统（推荐 APT）：
先加微软官方源：curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/microsoft-archive-keyring.gpg
再添加仓库：echo "deb [arch=arm64 signed-by=/usr/share/keyrings/microsoft-archive-keyring.gpg] https://packages.microsoft.com/repos/code stable main" | sudo tee /etc/apt/sources.list.d/vscode.list
最后安装：sudo apt update && sudo apt install code - 如果 APT 慢或失败（比如国内网络），改用 DEB：
下载：wget https://code.visualstudio.com/sha/download?build=stable&os=linux-deb-arm64 -O code_arm64.deb
安装：sudo dpkg -i code_arm64.deb，若报依赖缺失，立刻补：sudo apt -f install - Snap 虽方便（
sudo snap install code --classic），但它把 VSCode 锁在沙盒里，无法直接访问/dev/ttyUSB0（烧录串口）、/sys/firmware/devicetree（嵌入式调试）等路径，做 ARM 嵌入式开发时基本不可用
验证 VSCode 真的是 ARM64 原生运行
装完不等于跑对了。常见陷阱是：图标启动走的是旧版 x86_64 的快捷方式，或者终端里用 code 命令调起的是通过 Rosetta 启动的 Electron 进程。
- macOS：右键 Dock 中图标 → “显示简介”，确认“使用 Rosetta”未勾选；再打开“活动监视器”，筛选
Code，看“架构”列是否为Apple silicon - Linux/macOS 统一验证法：
启动 VSCode 后，在终端执行：ps aux | grep "Code Helper" | grep -v grep
找到Code Helper (Renderer)进程，其右侧应标arm64；若出现x86_64，说明底层 Node.js 运行时仍是 Intel 架构，扩展大概率加载失败 - 进 VSCode，按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Linux），搜“Developer: Toggle Developer Tools”，在控制台输：process.arch，返回必须是"arm64"
装完不能用？重点排查扩展与终端架构错配
ARM64 版 VSCode 装上就崩溃、插件全灰、终端打不开命令——八成不是 VSCode 本身问题，而是扩展或 Shell 拉了后腿。
- 扩展报
Unsupported architecture：不是所有插件都发布了 arm64 二进制。进设置搜extensions.experimental.affinity，设值为1（强制在主进程加载）；对仍报错的插件（如某些旧版 Python 插件），点开其详情页 → “版本”下拉菜单 → 手动选带arm64标签的旧版 - 集成终端里
arm-none-eabi-gcc找不到？别急着重装工具链。先在 VSCode 终端里执行uname -m，若输出x86_64，说明终端本身跑在 Rosetta 或错误 Shell 下。检查设置：terminal.integrated.defaultProfile.linux（或.osx）是否指向真实 arm64 Shell（如/bin/zsh），而不是某个封装过的 bash 脚本 - 调试 OpenOCD/GDB 失败？确保
openocd和arm-none-eabi-gdb也是 aarch64 编译的。用file $(which openocd)查看架构，输出含aarch64才合规；否则即使 VSCode 是 arm64，调试桥也会在第一步就断连
