Complete Guide: Install VS Code on macOS – wiki基地

作者： /

Complete Guide: Install VS Code on macOS

序言：拥抱强大的开发利器

Visual Studio Code（简称 VS Code）已迅速成为全球开发者最受欢迎的代码编辑器之一。它免费、开源、轻量级、高度可定制，支持几乎所有编程语言，并拥有一个庞大而活跃的扩展生态系统。对于 macOS 用户而言，VS Code 提供了一个流畅且高效的开发环境，它能很好地融入 macOS 的 Unix 内核环境，与终端、Git 等工具无缝协作。

本篇指南将手把手地引导您完成在 macOS 系统上安装 VS Code 的全过程。我们将探讨最常见的两种安装方法，详细介绍安装后的必要配置，以及如何保持软件更新、进行简单的故障排除，乃至如何在需要时将其彻底卸载。无论您是编程新手还是经验丰富的开发者，这篇指南都将确保您能顺利地在您的 Mac 上启动并运行 VS Code，为您的开发之旅奠定坚实的基础。

准备好了吗？让我们开始吧！

第一部分：安装前的准备工作

在开始安装之前，请确保您的 macOS 系统满足以下基本要求：

  1. macOS 版本： VS Code 支持 macOS High Sierra (10.13) 或更高版本。虽然它可能在更老的版本上运行，但为了获得最佳体验、安全性和兼容性，强烈建议您使用受支持的最新 macOS 版本。您可以点击屏幕左上角的苹果图标 -> “关于本机” 来查看您的 macOS 版本。
  2. 磁盘空间： VS Code 本身安装文件很小，通常不到 200MB。但是，随着您安装扩展、下载依赖项以及创建项目文件，所需的空间会增加。请确保您的硬盘有足够的可用空间，至少预留几个 GB 空间会比较稳妥。
  3. 网络连接： 下载安装文件和未来的扩展都需要稳定的互联网连接。
  4. 管理员权限： 安装应用程序通常需要您输入管理员密码。请确保您拥有该 Mac 用户的管理员权限。
  5. 基本 macOS 操作知识： 您需要知道如何打开应用程序、使用 Finder 查找和移动文件、以及可能需要使用终端（Terminal）执行一些命令（尤其是在使用 Homebrew 方法或配置 code 命令时）。

满足以上条件后，您就可以选择一种安装方法开始安装了。

第二部分：安装方法详解

在 macOS 上安装 VS Code 有两种主要且推荐的方法：通过官方网站下载安装包手动安装，或者使用 Homebrew 包管理器进行安装。两种方法各有优劣，您可以根据自己的偏好选择其一。

方法一：通过官方网站手动安装（推荐给大多数用户）

这是最直接、最常见的安装方法，适用于所有用户，尤其是那些不熟悉或不想使用命令行工具的用户。

优点： 简单直观，无需额外工具，直接从官方获取最新稳定版本。
缺点： 更新时需要手动下载新版本替换，或者依赖 VS Code 内置的自动更新功能（但有时手动替换更可靠）。

安装步骤：

  1. 访问官方网站： 打开您的网页浏览器（如 Safari, Chrome, Firefox），访问 VS Code 的官方下载页面：https://code.visualstudio.com/Download

  2. 下载 macOS 版本： 在下载页面，您会看到针对不同操作系统的下载选项。找到 macOS 部分，通常会提供两种架构版本：

    • Apple Silicon (ARM64): 适用于配备 Apple M1、M2、M3 等自研芯片的 Mac 电脑（例如 MacBook Air M1/M2, MacBook Pro M1/M2/M3/M3 Pro/Max/Ultra, Mac mini M1/M2, iMac M1, Mac Studio, Mac Pro M2 Ultra）。如果您的 Mac 是近几年购买的，很可能是 Apple Silicon 版本。
    • Intel Chip (x64): 适用于配备 Intel 处理器的老款 Mac 电脑。

    如何确定您的 Mac 是哪种芯片？ 点击屏幕左上角的苹果图标 -> “关于本机”。在弹出的窗口中，查看“芯片”或“处理器”一栏。如果是“Apple M1”、“Apple M2”等字样，则选择 Apple Silicon 版；如果是“Intel Core i…”等字样，则选择 Intel Chip 版。

    点击对应您 Mac 芯片架构的下载按钮（通常是一个 .zip 文件图标）。下载过程将自动开始。

  3. 找到下载文件： 下载完成后，在浏览器的下载列表中或通过 Finder 打开您的“下载”文件夹。您会找到一个名为 VSCode-darwin-universal.zip (Universal 通用版，同时包含 ARM64 和 x64，推荐) 或 VSCode-darwin-arm64.zip 或 VSCode-darwin-x64.zip 的压缩文件。

  4. 解压文件： macOS 通常会自动解压下载的 .zip 文件。如果您的 Mac 没有自动解压，双击该 .zip 文件，Finder 会自动将其解压，生成一个名为 “Visual Studio Code.app” 的应用程序图标。

  5. 移动到“应用程序”文件夹： 这是 macOS 的标准做法，将应用程序统一存放在“应用程序”文件夹中。

    • 打开一个新的 Finder 窗口。
    • 在 Finder 侧边栏中，点击“应用程序”（Applications）。
    • 将您刚刚解压得到的 “Visual Studio Code.app” 图标文件，拖拽 到“应用程序”文件夹窗口中。
    • 如果系统中已经有旧版本的 VS Code，系统会提示您是替换还是保留两者。通常选择“替换”（Replace）以更新到新版本。
    • 这个操作可能需要您输入 Mac 用户的管理员密码。

    重要提示： 虽然您可以将 Visual Studio Code.app 放在任意位置（比如桌面），但强烈建议将其放在“应用程序”文件夹中。这样做便于管理，也确保 macOS 的 Spotlight 搜索、Launchpad 等功能能正确识别和索引它。

至此，VS Code 的主体程序就安装完成了。您可以继续阅读下一部分，了解安装后的必要配置。

方法二：通过 Homebrew 包管理器安装（推荐给开发者）

Homebrew 是 macOS 上非常流行的第三方包管理器，它可以让您通过命令行方便地安装、更新和管理各种开发工具和应用程序。如果您已经在使用 Homebrew，或者愿意尝试命令行工具，那么使用 Homebrew 安装 VS Code 是一个非常高效的选择。

优点： 安装、更新和卸载都非常方便，只需一条命令；易于管理其他开发工具。
缺点： 需要先安装 Homebrew；需要使用终端（Terminal）。

安装步骤：

  1. 安装 Homebrew (如果尚未安装)： 如果您的 Mac 上已经安装了 Homebrew，请跳过此步骤。如果还没有，打开“终端”（Terminal）应用程序。您可以在“应用程序”->“实用工具”文件夹中找到它，或者使用 Spotlight 搜索 (Cmd + Space 然后输入 Terminal) 打开。

    在终端窗口中，粘贴并执行以下命令：
    bash
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    按照终端提示操作。它可能会要求您输入管理员密码，并可能提示您安装 Xcode Command Line Tools（如果尚未安装）。安装 Homebrew 需要一些时间，请耐心等待。安装完成后，终端会显示“Installation successful!”或类似的提示。为了确保 Homebrew 已正确添加到您的系统 PATH 环境变量中，按照 Homebrew 安装最后的提示，可能需要运行几条 brew shellenv 相关的命令，或者关闭并重新打开终端窗口。您可以通过运行 brew help 命令来验证 Homebrew 是否安装成功。

  2. 使用 Homebrew 安装 VS Code： Homebrew 使用一个叫做 cask 的扩展来管理图形界面应用程序。VS Code 可以通过 Homebrew Cask 来安装。

    在终端中，执行以下命令：
    bash
    brew install --cask visual-studio-code
    按下回车键。Homebrew 会自动下载最新版本的 VS Code 应用程序并将其安装到标准的 macOS 应用程序路径 (/Applications) 中。您会看到下载和安装的进度信息。

    如果您的 Mac 是 Apple Silicon 芯片，Homebrew 会自动下载适用于 ARM64 架构的版本。如果您的 Mac 是 Intel 芯片，Homebrew 会下载 x64 版本。Homebrew 会自动识别您的系统架构。

  3. 等待安装完成： Homebrew 会显示安装成功的消息。

使用 Homebrew 安装方法，VS Code 的主体程序也已经安装完成了。接下来，是时候进行一些重要的配置了。

第三部分：安装后的必要配置

安装完 VS Code 应用程序后，您需要进行一些重要的配置，以确保其功能完整并能与您的开发工作流无缝集成。

1. 首次启动 VS Code 并处理安全提示

无论是通过官方网站还是 Homebrew 安装，第一次打开 VS Code 时，macOS 的 Gatekeeper 安全功能可能会弹出一个提示框，询问您是否确定要打开这个从互联网下载的应用程序。

  • 点击“打开”（Open）。
  • 如果系统提示您输入管理员密码，请按提示操作。

一旦批准，VS Code 就会正常启动。下次启动时就不会再有这个提示了。

2. 添加 code 命令到 PATH 环境变量（非常重要）

这是在 macOS 上安装 VS Code 后最重要的配置之一，尤其是对于开发者。添加 code 命令到系统 PATH 后，您就可以直接在终端（Terminal）中输入 code . 来打开当前文件夹，或者输入 code 文件名 来打开特定文件。这将极大地提高您的工作效率，实现编辑器和终端之间的快速切换。

VS Code 提供了一个非常简便的方式来完成这个配置。

配置步骤：

  1. 打开 VS Code： 启动您刚刚安装好的 Visual Studio Code 应用程序。
  2. 打开命令面板： 使用快捷键 Cmd + Shift + P 或者点击菜单栏的 View (视图) -> Command Palette... (命令面板...)。
  3. 输入命令： 在命令面板的输入框中，开始输入 “shell command”。您会看到相关的建议命令列表。
  4. 选择安装命令： 从列表中选择 Shell Command: Install 'code' command in PATH。点击它。
  5. 等待提示： VS Code 会执行一个操作，将 code 命令的符号链接（symlink）添加到您的系统 PATH 目录中（通常是 /usr/local/bin）。成功后，VS Code 右下角会弹出一个提示，显示 “Shell command ‘code’ successfully installed in PATH.”。

如果提示安装失败，或者您在终端中尝试 code . 时出现 command not found 的错误：

  • 重启终端： 关闭所有打开的终端窗口，然后重新打开一个终端窗口。系统 PATH 的更改通常在新的终端会话中生效。再次尝试 code .。
  • 检查 PATH： 在终端中输入 echo $PATH，查看 /usr/local/bin 是否包含在输出路径列表中。VS Code 的安装命令通常会将其添加到这个标准位置。
  • 手动检查符号链接： 理论上，VS Code 的安装命令会在 /usr/local/bin 中创建一个名为 code 的符号链接，指向 VS Code 应用程序内部的可执行文件路径（例如 /Applications/Visual Studio Code.app/Contents/Resources/app/bin/code）。您可以在终端中使用 ls -l /usr/local/bin/code 来验证这个符号链接是否存在且指向正确。
  • 手动配置 (仅在自动方法无效时尝试)： 虽然不推荐作为首选，但如果自动方法持续失败，您可以考虑手动修改您的 shell 配置文件。
    • 确定您使用的 shell：大多数 macOS Catalina (10.15) 及更新版本默认使用 Zsh。旧版本可能使用 Bash。您可以在终端顶部标题栏或通过 echo $SHELL 命令查看。
    • 打开对应的配置文件：
      • 对于 Zsh：open ~/.zshrc
      • 对于 Bash：open ~/.bash_profile (如果不存在，尝试 open ~/.profile)
    • 在文件末尾添加一行（如果 /usr/local/bin 不在 PATH 中）：
      bash
      export PATH="/usr/local/bin:$PATH"
      或者更精确地添加 VS Code 的 bin 目录（如果符号链接方法无效）：
      bash
      export PATH="/Applications/Visual Studio Code.app/Contents/Resources/app/bin:$PATH"
    • 保存并关闭文件。
    • 在终端中执行 source ~/.zshrc (或 source ~/.bash_profile) 使更改立即生效，或者直接关闭并重新打开终端。

配置 code 命令后，您将能够流畅地在终端和编辑器之间切换，例如在项目文件夹中使用 code . 快速打开整个项目。

3. 熟悉欢迎界面和基本设置

首次启动 VS Code，您会看到一个欢迎界面（Welcome Page）。这个页面提供了许多有用的链接，包括：

  • Start (开始): 快速创建新文件、打开文件或文件夹。
  • Recent (最近): 显示您最近打开的项目或文件列表。
  • Customize (自定义): 提供了安装语言包、选择主题、同步设置等常用功能的快速入口。
  • Learn (学习): 指向官方文档、交互式教程等学习资源。

花点时间浏览一下欢迎界面，这能帮助您快速了解 VS Code 的一些基础功能。

一些基本的设置建议：

  • 安装语言包： 如果您希望 VS Code 的界面显示为中文，可以在欢迎界面的“Customize”部分找到“Install a language pack”，搜索并安装“Chinese (Simplified)”。安装完成后，根据提示重启 VS Code 即可切换语言。
  • 选择主题： VS Code 内置了多种颜色主题和文件图标主题。您可以在“Customize”中找到“Color Theme”和“File Icon Theme”进行选择，找到您喜欢的界面风格。
  • 设置同步 (Settings Sync)： 如果您在多台电脑上使用 VS Code，强烈建议您启用设置同步功能。它可以使用您的 GitHub 或 Microsoft 账户同步您的设置、扩展、键盘快捷键、用户代码片段等。这能确保您在任何设备上都能获得一致的开发体验。您可以在欢迎界面找到入口，或者通过 Cmd + Shift + P 打开命令面板，搜索 “Settings Sync”。

4. 安装您的第一个扩展

VS Code 的强大很大程度上归功于其丰富的扩展市场。无论您使用哪种编程语言、框架或工具，几乎都能找到相应的扩展来提供语法高亮、智能代码补全（IntelliSense）、调试支持、代码格式化、Linter 检查、Git 集成增强等功能。

  • 点击左侧活动栏中的“扩展”图标（通常是四个方块，其中一个分离出来）。
  • 在搜索框中输入您需要的扩展名称（例如 Python, Java Extension Pack, ESLint, Prettier, Docker, GitLens 等）。
  • 找到目标扩展后，点击“安装”按钮。
  • 安装完成后，有些扩展可能需要您重新加载窗口（Reload Window），VS Code 会提示您。

尝试安装一个您正在学习或使用的编程语言的官方扩展包，例如用于 Python 开发的 Microsoft 官方 Python 扩展。它会为您提供强大的语言支持。

第四部分：保持 VS Code 更新

软件更新通常包含新功能、性能改进和安全补丁。保持 VS Code 更新对于获得最佳体验和确保安全性非常重要。

VS Code 提供了两种主要的更新方式：

  1. 自动更新（默认）： VS Code 默认会定期检查更新，并在有新版本可用时在右下角弹出提示。您可以选择“更新并重启”来应用更新。这是最省心的方式。
  2. 手动检查更新： 如果您想随时检查是否有新版本，可以点击菜单栏的 Code -> Check for Updates...。如果发现更新，会提示您下载和安装。

通过 Homebrew 安装的用户更新方法：

如果您使用 Homebrew 安装的 VS Code，理论上 VS Code 本身也会提示更新。但更“Homebrew 原生”的更新方式是通过终端命令：

  • 打开终端。
  • 运行命令：brew upgrade --cask visual-studio-code

这条命令会检查 Homebrew Cask 中所有已安装的应用程序是否有更新，并升级 VS Code 到最新版本。如果您只更新 VS Code，可以明确指定 visual-studio-code。

选择适合您的更新方式，并尽量保持您的 VS Code 是最新版本。

第五部分：故障排除常见问题

在使用或安装 VS Code 的过程中，您可能会遇到一些问题。以下是一些常见问题及其解决方案：

  1. VS Code 无法打开或提示“已损坏”：

    • 原因： 这通常是 macOS Gatekeeper 安全机制的提示，因为它识别到应用程序不是从 App Store 安装的，或者下载过程中文件可能轻微损坏。
    • 解决方案：
      • 第一次打开时，右键点击 VS Code 图标，选择“打开”。在弹出的警告框中，再次点击“打开”。这样做是告诉 macOS 您信任此应用程序。
      • 确保您将 Visual Studio Code.app 文件完整地拖拽到了“应用程序”文件夹。
      • 如果问题依然存在，尝试删除当前安装的 VS Code (将其从应用程序文件夹拖到废纸篓)，清空废纸篓，然后重新从官方网站下载最新的安装包并重新安装。

  2. 终端中输入 code . 提示 command not found：

    • 原因： code 命令未正确添加到您的系统 PATH 环境变量中，或者终端窗口未刷新 PATH。
    • 解决方案：
      • 重新打开 VS Code。
      • 打开命令面板 (Cmd + Shift + P)。
      • 执行 Shell Command: Install 'code' command in PATH。
      • 关闭所有终端窗口，然后重新打开一个新的终端窗口，再次尝试 code .。
      • 如果问题仍未解决，参考前面“添加 code 命令到 PATH”部分的手动配置步骤，检查或手动修改您的 shell 配置文件 (.zshrc, .bash_profile 等)。

  3. 扩展无法安装或安装后不工作：

    • 原因： 网络问题、扩展本身的兼容性问题、或者 VS Code 缓存问题。
    • 解决方案：
      • 检查您的网络连接。
      • 尝试重启 VS Code。有时简单的重启可以解决扩展加载问题。
      • 打开命令面板 (Cmd + Shift + P)，搜索并执行 Developer: Reload Window。这会重新加载 VS Code 界面和所有扩展。
      • 检查 VS Code 的“输出”（Output）面板，选择“Log (Extension Host)”或“Log (Window)”查看是否有相关的错误信息。
      • 尝试卸载并重新安装该扩展。
      • 检查扩展的官方文档或 GitHub 仓库，看是否有已知的兼容性问题或特定要求。

  4. VS Code 运行缓慢或占用资源过多：

    • 原因： 可能安装了过多或资源消耗大的扩展，处理超大型文件，或者项目文件夹过于庞大。
    • 解决方案：
      • 尝试禁用一些不常用的扩展。您可以在扩展面板中禁用单个扩展，或者使用命令面板 (Cmd + Shift + P) 中的 Developer: Disable All Installed Extensions 来临时禁用所有第三方扩展，以判断问题是否由扩展引起。
      • 对于大型项目，确保您的 .gitignore 文件配置正确，避免 VS Code 索引大量不必要的文件（如 node_modules）。
      • 检查 VS Code 的进程管理器 (Help -> Open Process Explorer)，查看是哪个进程（主进程、渲染器进程或某个扩展）占用了大量 CPU 或内存。
      • 确保您的 Mac 系统本身有足够的内存和处理能力。

  5. 设置或用户数据丢失：

    • 原因： 非正常关闭、文件损坏或手动误删用户数据文件。
    • 解决方案： 如果您之前启用了设置同步，可以尝试重新同步您的设置。如果没有，并且您备份了用户数据目录，可以尝试恢复。VS Code 的用户数据通常位于 ~/Library/Application Support/Code/ 目录。

在遇到问题时，首先尝试重启 VS Code 和您的 Mac。如果问题依然存在，查阅 VS Code 官方文档或在线搜索错误信息通常能找到解决方案。

第六部分：卸载 VS Code

如果您出于某种原因需要从 Mac 上移除 VS Code，操作也非常简单。需要注意的是，将应用程序拖到废纸篓只会删除应用程序本身，而不会删除您的用户设置、已安装的扩展等数据。如果您想完全清除所有相关文件，需要额外进行一些步骤。

卸载步骤：

  1. 关闭 VS Code： 确保 VS Code 应用程序已完全退出 (Cmd + Q)。
  2. 删除应用程序：
    • 打开 Finder。
    • 在 Finder 侧边栏中，点击“应用程序”（Applications）。
    • 找到 “Visual Studio Code.app” 图标。
    • 将其拖拽到 Dock 栏上的“废纸篓”（Trash）图标中。
    • 或者右键点击图标，选择“移到废纸篓”。
  3. 清空废纸篓： 右键点击 Dock 栏上的“废纸篓”图标，选择“清空废纸篓”。这将彻底删除应用程序文件。

删除用户数据（可选，如果您想完全清除所有痕迹）：

  • 警告： 执行此步骤将永久删除您的所有 VS Code 设置、已安装的扩展、键盘快捷键、用户代码片段等。如果您将来可能重新安装 VS Code 并希望保留这些，请不要执行此步骤，或者提前备份相关文件夹。

  • 打开 Finder。

  • 在菜单栏中，点击 前往 (Go) -> 前往文件夹... (Go to Folder...)。
  • 在弹出的输入框中，输入以下路径并点击“前往”：
    ~/Library/Application Support/Code/
    这将带您进入存储 VS Code 用户设置、快捷键、代码片段等数据的文件夹。将 Code 文件夹移到废纸篓。
  • 再次使用 前往 (Go) -> 前往文件夹... (Go to Folder...)，输入以下路径并点击“前往”：
    ~/.vscode/
    这将带您进入存储 VS Code 已安装扩展的文件夹。将 .vscode 文件夹移到废纸篓。注意，这是一个隐藏文件夹（以点开头），可能需要在 Finder 设置中显示隐藏文件才能看到。您也可以直接通过“前往文件夹”访问它。
  • （可选）清理缓存文件：
    ~/Library/Caches/com.microsoft.VSCode/
    ~/Library/Caches/com.microsoft.VSCode.ShipIt/
    ~/Library/Preferences/com.microsoft.VSCode.plist
    ~/Library/Saved Application State/com.microsoft.VSCode.savedState/
    将找到的与 VS Code 相关的文件夹或文件移到废纸篓。
  • 最后，清空废纸篓以彻底删除这些文件。

至此，VS Code 及其相关的用户数据就从您的 Mac 上彻底卸载了。如果您是通过 Homebrew 安装的，还可以运行 brew uninstall --cask visual-studio-code 命令来通过 Homebrew 的方式进行卸载（它主要会删除应用程序文件，用户数据仍需手动清理）。

第七部分：为何 VS Code 在 macOS 上是绝佳选择

VS Code 在 macOS 上的流行并非偶然，它与 macOS 系统环境有着良好的契合度：

  • 无缝的终端集成： macOS 基于 Unix，其终端是开发者常用的工具。VS Code 的内置终端以及通过 code 命令从外部终端打开文件的能力，提供了流畅的命令行与 GUI 编辑器结合的工作流。
  • 出色的 Git 支持： macOS 预装了 Git。VS Code 强大的内置 Git 版本控制功能（侧边栏、文件差异视图、分支管理等），配合 GitLens 等扩展，使得在 Mac 上进行版本控制变得异常高效。
  • 性能与响应： 尽管 VS Code 基于 Electron 框架构建，但在 macOS 上通常能提供流畅的性能和快速的启动速度。
  • 外观与体验： VS Code 在 macOS 上遵循了部分原生的 UI 指南，使得其界面和操作习惯能较好地融入 macOS 环境，给用户带来相对一致的使用体验。
  • 广泛的语言和技术支持： 无论您是进行 Web 开发（Node.js, React, Angular, Vue）、移动开发（React Native, Flutter）、后端开发（Python, Java, Go, .NET Core）还是系统编程，VS Code 都有强大的扩展支持，满足您在 macOS 上的各种开发需求。

结论：开启您的 macOS 开发之旅

恭喜您！通过本篇详细指南，您已经成功地在您的 macOS 系统上安装并配置好了 Visual Studio Code。从选择合适的安装方法，到添加至关重要的 code 命令，再到了解如何管理扩展和保持软件更新，您现在已经掌握了在 Mac 上高效使用 VS Code 的基础。

VS Code 只是一个工具，但它是一个能极大地提升您开发效率和乐趣的强大工具。接下来，我们鼓励您：

  • 探索扩展市场： 寻找适合您正在学习或使用的语言、框架和工作流的扩展。
  • 自定义您的设置： 根据您的喜好调整编辑器外观、字体、行为等。
  • 学习快捷键： 熟练使用快捷键能显著提高您的编码速度。VS Code 提供丰富的快捷键，并且您可以根据需要自定义。
  • 查阅官方文档： VS Code 的官方文档非常详尽，是学习其高级功能和解决疑难杂症的最佳资源。

VS Code 在 macOS 上的安装和配置并不复杂，但通过详细的步骤和注意事项，我们希望能帮助您避免常见的障碍，让您能更快地投入到激动人心的编程世界中。现在，打开您的 VS Code，开始编码吧！祝您在 macOS 上的开发之旅一切顺利！

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部