VS Code Windows on ARM 的 ARM64 版运行说明

简介

VS Code 的 ARM64 版专为 Windows on ARM 设备（如 Surface Pro X）设计，提供原生运行体验，避免 x64 版本在转译下的性能损失和兼容问题。本文基于官方文档和社区反馈，说明如何获取、安装并配置 ARM64 版，同时解决调试、扩展兼容等常见问题。适合使用 ARM64 笔记本、二合一设备或云桌面进行代码开发的工程师，尤其是需要 C++、Python 或容器工作负载的用户。核心优势在于原生性能、与 WSL 的无缝集成，以及官方对 ARM64 的持续支持。

核心功能

• 原生 ARM64 支持：VS Code 提供 ARM64 安装包，无需转译即可在 Windows on ARM 上运行，降低延迟并减少内存占用。
• WSL 集成：通过 WSL 扩展，可在 Windows 上运行 Linux 发行版，并在 VS Code 中直接开发、调试 Linux 应用，支持四种运行模式（原生 Windows、原生 Linux、Remote Tunnels、OpenVSCode Server）。
• Docker 容器开发：配合 Docker 扩展，可创建、运行和管理容器，支持在 ARM64 设备上构建多架构镜像。
• C++ IntelliSense 与构建：VS Code C++ 扩展提供原生 ARM64 的 IntelliSense 和生成支持，用于开发在 ARM64 设备上本机运行的 Windows 应用程序。
• GitHub Actions 集成：Windows Arm64 托管运行器已正式支持 GitHub Actions，可无缝将 Windows on Arm 目标整合到 CI/CD 流程。
• 远程开发：通过 Remote Tunnels 或 OpenVSCode Server，可在 ARM64 设备上连接远程环境，实现跨架构开发。

使用场景

• 在 ARM64 设备上开发原生 Windows 应用：使用 C++ 扩展，编译并调试 ARM64 本机代码，避免转译导致的性能瓶颈。
• 使用 WSL 进行 Linux 开发：在 Windows on ARM 上安装 WSL，配合 VS Code 扩展，在本地 Windows 环境中开发、测试 Linux 软件。
• 容器化应用开发：通过 Docker 扩展创建容器，利用 ARM64 原生支持构建并运行容器，适合微服务或云原生开发。
• CI/CD 流水线：使用 GitHub Actions 的 Windows Arm64 托管运行器，在 ARM64 环境执行构建、测试和部署任务。
• 远程开发与协作：通过 Remote Tunnels 连接远程开发机，或使用 OpenVSCode Server 在浏览器中编辑代码，适用于低功耗 ARM 设备。

安装与获取步骤

1. 访问官方下载页面 https://code.visualstudio.com/download ，选择 Windows ARM64 安装包（通常标记为 ARM64 或 arm64）。
2. 下载后运行安装程序，按提示完成安装。安装完成后，在“关于”对话框中确认版本信息显示为 ARM64 架构。
3. 若需使用 WSL，先在 Windows 上启用 WSL 功能并安装 Linux 发行版，然后在 VS Code 中安装 WSL 扩展，通过“Remote-WSL”窗口打开项目。
4. 安装 Docker 扩展并确保 Docker Desktop 已安装且支持 ARM64 后端，然后通过 VS Code 的 Docker 面板创建或管理容器。
5. 对于 C++ 开发，安装 C++ 扩展，并确保已安装 ARM64 版本的编译工具链（如 MSVC 或 Clang），以支持本机编译和调试。

参数与版本速查

VS Code 的 ARM64 版与 x64 版在功能上保持一致，但部分扩展可能尚未提供原生 ARM64 版本，此时会通过 x64 转译运行，可能影响性能。官方支持页面 https://code.visualstudio.com/docs/supporting/faq 列出了常见平台问题。对于 .NET 开发，.NET 8+ 支持原生 Arm64 运行；对于 Python，需安装 ARM64 版本的 Python 3.9.x 或更高，以确保调试功能正常。

与同类方案的区别

与 Visual Studio 2022 的 ARM64 原生版本相比，VS Code 更轻量，适合快速编辑和脚本任务；而 Visual Studio 提供更完整的 IDE 体验，但占用资源更多。在 ARM64 设备上，VS Code 的扩展生态更丰富，但需注意扩展的架构兼容性。使用 WSL 时，VS Code 的 Remote 模式可避免在 Windows 和 Linux 间切换，而 Visual Studio 的 WSL 支持相对有限。

注意事项

• 确保安装的是 ARM64 版本，而非 x64 版本，否则会触发转译，导致性能下降和某些功能异常（如自动更新错误）。
• 部分扩展可能不支持 ARM64，运行时会提示“arm64-win32 平台不支持”，此时可尝试安装 x64 版本扩展，但需接受性能损失。
• 调试 Python 时，必须安装 ARM64 版本的 Python，并确保解释器路径正确，否则调试器无法启动。
• 使用 WSL 时，需确保 WSL 发行版为 ARM64 架构，否则可能无法与 VS Code 正常通信。
• 若遇到自动更新失败（如 x64 版本在 ARM64 上更新报错），建议手动下载 ARM64 安装包覆盖安装。
• 对于需要原生性能的编译任务，建议使用 ARM64 工具链，避免转译导致的兼容问题（如某些软件误判为“被调试”而终止）。