第零章：环境配置与开发工具（macOS 版，基于 Anaconda）

更新时间: 2026-09-08 19:19 · 中文版
目录 (10)

Language / 语言：English Version | 中文版

本课程使用两款软件：

  1. Anaconda：提供 Python 运行环境与 Conda 包管理器；
  2. Visual Studio Code（简称 VS Code）：用来编写代码的文本编辑器。

版本说明（2026-09-08）：当前 Anaconda Distribution 的 macOS 安装包面向 Apple 芯片，系统要求为 macOS 12.1 或更新版本。Intel Mac 可从官方归档选择旧版；2025.06 是最后支持 Intel Mac 的 Distribution 版本系列。安装前请核对系统要求与版本说明。

文中的版本号是输出格式示例，实际数字可能不同。软件界面的文字和位置也可能随版本变化。Windows 用户请阅读 Windows 版（基于 Anaconda）。若需要安装轻量级的官方纯 Python 环境，请阅读 macOS 版（纯 Python 环境）。

本章介绍这两个软件在 macOS 系统中的下载、安装与初始配置步骤，并完成第一个 Python 程序的编写与运行。在程序运行成功后，再介绍这两个工具的具体作用与分工。

第一部分：核心主线

0.1 安装 Anaconda

0.1.1 确认系统版本与芯片类型

苹果 Mac 电脑近年来有两种不同架构的处理器芯片。在下载软件前，需要先确认自己电脑的芯片类型：

  1. 点击屏幕左上角的苹果标志（）；
  2. 在下拉菜单中点击 关于本机（About This Mac）；
  3. 记录 macOS 版本，再查看“芯片”或“处理器”一栏：
    • 如果“芯片”一栏显示 Apple M 系列，说明属于 Apple 芯片；
    • 如果显示为 Intel Core i5 / i7 等，说明属于 Intel 芯片。

确认芯片类型后，即可进行针对性下载。

0.1.2 下载安装包

  1. Apple 芯片电脑访问 Anaconda 下载页，选择 Anaconda Distribution 的 Apple silicon Graphical Installer。图形安装包文件名包含 MacOSX-arm64.pkg；
  2. Intel Mac 访问官方归档，查找文件名包含 MacOSX-x86_64.pkg 的安装包。根据自己的 macOS 版本，结合旧版安装说明与发布说明选择版本；
  3. 如下载页显示注册提示，可以选择 Skip registration（跳过注册）继续查看下载选项；
  4. 记录所选安装包的文件名。注意区分 .pkg 图形安装包与 .sh 终端安装包，下面使用 .pkg。

0.1.3 安装步骤

下载完成后，在“访达”的“下载”文件夹中双击运行 .pkg 安装包，按照向导完成安装：

  1. 允许安装提示：系统可能弹出“此软件包将运行一个程序以确定该软件能否安装”，点击 允许 或 继续；
  2. 欢迎与介绍界面：点击 继续；
  3. 许可协议：阅读协议后点击 继续，在弹出的窗口中点击 同意（Agree）；
  4. 选择安装类型（关键步骤）：
    • 在“安装类型”步骤，按安装器提供的选项选择安装位置，记下实际路径，然后点击 继续。后面选择解释器和排查路径问题时会用到它；
  5. 开始安装：
    • 点击 安装 按钮；
    • 此时系统会弹出密码确认窗口，输入您的 Mac 开机登录密码（或轻触指纹 Touch ID）授权安装；
  6. 等待安装完成：安装所需时间取决于电脑性能。提示安装成功后，点击 关闭；
  7. 清理安装包：安装器关闭时，系统通常会询问“是否将‘Anaconda3’安装器移到废纸篓”，点击 移到废纸篓，释放安装包占用的硬盘空间。

0.1.4 验证安装

安装完成后，检验 Anaconda 是否正常安装成功：

案例：通过 macOS 终端查看当前安装的 Conda 与 Python 版本号。

  1. 按键盘快捷键 Cmd + 空格键 唤起“聚焦搜索”（Spotlight）；
  2. 在搜索框中输入：终端（或 Terminal），按回车打开终端窗口；
  3. 在终端光标处输入以下命令并按回车：
    bash 
    conda --version
    若输出类似 conda 24.x.x 的版本信息，说明 Conda 管理器已就绪；
  4. 继续输入以下命令并按回车：
    bash 
    python --version
    若输出类似 Python 3.12.x 的版本信息，说明 Python 运行环境安装成功。此时可以关闭终端窗口。

0.2 安装 Visual Studio Code

0.2.1 下载安装包

  1. 访问 VS Code 下载页，查看 macOS 系统要求；
  2. 根据芯片类型选择 Apple silicon 或 Intel chip，也可以选择兼容两者的 Universal；
  3. 下载 .dmg 磁盘映像文件。

0.2.2 将 VS Code 放入“应用程序”文件夹

案例：安装 VS Code，并从“应用程序”文件夹启动编辑器。

  1. 在“访达”的“下载”文件夹中双击 .dmg 文件；
  2. 在打开的窗口中，将 Visual Studio Code.app 拖到 Applications（应用程序）；
  3. 复制完成后，从“应用程序”文件夹打开 VS Code。

以上步骤对应当前的 .dmg 安装包。若下载的是旧版 .zip，先解压，再把应用拖到“应用程序”。VS Code macOS 安装说明。

0.2.3 首次启动

  1. 打开“访达” → 进入“应用程序”文件夹，找到并双击打开 Visual Studio Code（也可以在“启动台”中找到它）；
  2. 首次打开时，macOS 会弹出系统提示：“Visual Studio Code 是从互联网下载的 App。您确定要打开它吗？”，点击 打开 即可正常进入主界面。

0.3 VS Code 初始化配置

刚安装好的 VS Code 界面为英文，并且尚未配置 Python 语言插件。按照以下三步完成基础设置：

0.3.1 安装简体中文语言包

  1. 打开 VS Code，在左侧边栏找到形状像四个方块的图标（Extensions，快捷键为 Cmd + Shift + X）；
  2. 在上方的搜索框中输入：Chinese；
  3. 找到 Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code，核对发布者为 Microsoft；
  4. 点击该扩展的 Install 按钮；
  5. 安装完成后，界面右下角会弹出一个提示小窗口，提示“Change Language and Restart”；
  6. 点击该按钮，VS Code 会自动重启，重启后界面变为中文。

0.3.2 安装 Python 扩展插件

  1. 再次点击左侧活动栏的“扩展”图标（或按 Cmd + Shift + X）；
  2. 在搜索框中输入：Python；
  3. 找到由 Microsoft 官方发布的名为 Python 的插件（带有蓝黄双色 Python 图标）；
  4. 点击 安装（Install）按钮，等待片刻即可安装完成。

0.3.3 选择 Anaconda 的 Python 解释器

安装好插件后，需要让 VS Code 绑定刚刚安装的 Anaconda 环境：

  1. 在 VS Code 中按下快捷键 Cmd + Shift + P（或者点击顶部菜单栏的“查看” → “命令面板”），屏幕上方正中会弹出一个输入框；
  2. 在输入框中输入：Python: Select Interpreter，然后点击出现的对应选项；
  3. 此时列表会列出检测到的 Python 环境。在列表中找到带有 conda 或 base 字样的选项（路径通常显示为 /opt/anaconda3/bin/python 或 ~/anaconda3/bin/python）；
  4. 点击选中该项。配置完成后，VS Code 底部状态栏的右下角会显示当前所选的环境名称，例如 Python 3.12.x ('base': conda)。

0.4 编写与运行第一个程序

下面创建课程文件夹，保存并运行第一个程序。

0.4.1 新建工作文件夹

把课程代码保存在一个固定的文件夹中，方便查找。

案例：在 Mac 的“文稿”（Documents）目录下新建一个名为 python_code 的文件夹，并在 VS Code 中打开该工作区。

  1. 打开“访达”（Finder），点击左侧边栏的 文稿（Documents）；
  2. 在空白处点击鼠标右键（或按住 Control 点击），选择“新建文件夹”，命名为 python_code；
  3. 打开 VS Code，点击顶部菜单栏的“文件” → “打开文件夹...”（快捷键 Cmd + O）；
  4. 找到并选中刚才新建的 python_code 文件夹，点击右下角的“打开”；
  5. 界面会弹出“是否信任此文件夹中的文件的作者”安全确认窗口，点击“是，我信任此作者”。

0.4.2 新建代码文件

  1. 打开文件夹后，查看 VS Code 左侧的“资源管理器”侧边栏，可以看到大写的 PYTHON_CODE 文件夹名称；
  2. 将鼠标悬停在文件夹名称右侧，点击出现的“新建文件”图标（带有加号的文件图标）；
  3. 输入文件名：hello.py，然后按回车确认（本课程的 Python 代码文件使用 .py 后缀）；
  4. 编辑区随即打开空白的 hello.py 文件。

0.4.3 输入并运行代码

在打开的 hello.py 文件中，输入以下一行代码：

案例：运行一行代码，让终端显示 Hello, world!。

python 
print("Hello, world!")

输入完毕后，按键盘快捷键 Cmd + S 保存文件（未保存时文件名旁边会有一个实心小圆点，保存后小圆点消失）。

运行代码（两种常见方式任选其一）：

  • 方式一（推荐）：点击编辑区右上角的小三角图标（形状像播放键，悬停提示为“在专用终端中运行 Python 文件”）；
  • 方式二：在代码编辑区任意空白处点击鼠标右键，在弹出的右键菜单中选择“在终端中运行 Python 文件”。

点击运行后，VS Code 界面下方会自动弹出一个“终端”面板，并在片刻后输出执行结果：

text 
Hello, world!

看到这行输出，说明当前解释器已经成功运行 hello.py。把引号中的文字改成自己的姓名，再次运行，观察输出变化。

0.5 认识刚才安装的工具

0.5.1 Python 解释器与 Anaconda

Python 解释器负责执行 Python 代码。刚才运行 hello.py 时，解释器执行了文件中的 print(...)，把文字写到终端。

Anaconda 包含 Python 和一些常用工具包。本章使用的是其中的 Python。Conda 用于查看、安装和管理软件包及运行环境，需要其他工具包时可以通过它安装。

0.5.2 VS Code

VS Code 用于编写和保存代码。它可以显示语法颜色、提示代码补全，并在同一窗口内打开终端。安装 Python 扩展后，可以选择解释器并运行 .py 文件。

0.5.3 从代码文件到运行结果

在 VS Code 中保存 hello.py → 选择“在终端中运行 Python 文件” → 所选 Python 解释器执行文件 → 终端显示输出。

编辑代码与执行代码是两个步骤。确认自己正在运行的文件和解释器，有助于排查“改了代码但结果没变化”或“找不到工具包”等问题。

第二部分：扩展阅读

在日常使用 Mac 进行编程时，可能会遇到一些平台特有的操作疑问。这里汇总了常见问题的排查方法以及常用的快捷键设置。

0.6 macOS 常见问题排查（FAQ）

0.6.1 终端提示 zsh: command not found: conda

这条消息表示当前终端找不到 conda 命令。先对照安装时记录的位置，确认 Anaconda 安装在哪个目录；安装目录由安装选项决定。

案例：激活安装在 /opt/anaconda3 的环境，并让之后打开的 zsh 终端能找到 Conda。

bash 
source /opt/anaconda3/bin/activate
conda init zsh

这里的 /opt/anaconda3 是路径示例。如果实际安装在 ~/anaconda3 或其他目录，将第一行改为实际目录下的 bin/activate。关闭终端后重新打开，运行 conda --version 检查。若仍然报错，按完整错误信息查阅 Anaconda 排查说明。

0.6.2 找不到运行三角形按钮或提示未选择解释器

  • 问题表现：VS Code 编辑区右上角没有出现运行按钮，或者右下角弹出提示 Select an Interpreter；
  • 解决方法：
    1. 检查当前文件后缀名是否为 .py，如果保存成了文本格式（如 .txt），VS Code 不会激活 Python 运行功能；
    2. 按快捷键 Cmd + Shift + P，输入 Python: Select Interpreter 并回车；
    3. 在弹出的列表中重新点击选择包含 conda 的 Python 解释器路径。

0.7 提高效率的日常使用设置

0.7.1 开启“自动保存”功能

可以养成运行前按 Cmd + S 保存文件的习惯。Python 扩展的“在终端中运行 Python 文件”命令也会自动保存文件；其他运行方式可能不同。运行说明。

可以在 VS Code 中开启自动保存：

  1. 点击顶部菜单栏的“文件”（File）；
  2. 勾选 自动保存（Auto Save）；
  3. 勾选后，VS Code 会按当前自动保存设置保存文件。

0.7.2 macOS 键盘与快捷键习惯速查

在 macOS 中，键盘按键与 Windows 存在对应关系：

  • 许多常用快捷键在 Mac 上使用 Command 键（⌘），在 Windows 上使用 Ctrl 键；
  • Option 键（⌥） 也常标为 Alt；具体组合以软件菜单或快捷键说明为准。

常用的 VS Code 快捷键如下：

快捷键 功能说明
Cmd + S 保存当前正在编辑的文件
Cmd + / 单行代码注释 / 取消注释（在代码前快速添加 #）
Cmd + Shift + P 打开命令面板（可搜索所有 VS Code 功能指令）
Cmd + B 显示或隐藏左侧边栏（腾出更多代码编辑视野）
Ctrl + 反引号键 打开或隐藏底部的集成终端（注意：此处使用 Control 键）

0.8 Conda 基础指令速查

日常学习中，绝大部分代码直接在 VS Code 中点击运行即可。如果需要在 Mac 终端中查看自己的 Python 环境，可以打开“终端”，使用以下几条常用命令：

案例：在 Mac 终端中查看当前安装的所有 Python 工具库清单。

bash 
# 查看当前环境中安装的所有工具库及其版本
conda list

常用基础命令汇总：

  • conda --version：查看当前 Conda 版本；
  • conda list：列出当前环境中已安装的所有软件包；
  • python：直接进入交互式 Python 命令行（输入 exit() 退出）；
  • python 文件名.py：在终端中直接运行指定的 Python 代码文件。

自行检查

记录 macOS 版本、芯片类型、Anaconda 安装包文件名与 python --version 输出。对照官方说明，说明自己为什么选择这个安装包；再修改 hello.py 的输出文字并运行。

章节导航：课程首页 | 下一章：第一章 基本数据类型与基础运算