第零章：环境配置与开发工具（Windows 版，基于 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 的 Windows 系统要求为 Windows 11 23H2 或更新版本、64 位 x86 架构；官方计划于 2026-11-10 停止支持 23H2 及更早版本。Windows 10 用户可查阅旧版安装说明，自行选择与系统兼容的安装包。安装前请核对系统要求与旧版安装说明。

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

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

第一部分：核心主线

0.1 安装 Anaconda

0.1.1 下载安装包

  1. 访问 Anaconda 下载页，找到 Anaconda Distribution 的 Windows 图形安装包；
  2. 如页面显示注册提示，可以选择 Skip registration（跳过注册）继续查看下载选项；
  3. 核对安装包适用的系统版本与架构。Windows x64 图形安装包的文件名包含 Windows-x86_64.exe；
  4. 需要其他版本时，在官方归档中按文件名、发布日期与版本说明选择。下载后记录文件名，安装遇到问题时可据此查找对应说明。

0.1.2 安装步骤

下载完成后，双击运行下载好的 .exe 安装程序，按照以下步骤操作：

  1. 欢迎界面（Welcome）：点击 Next 继续；
  2. 许可协议（License Agreement）：阅读协议后，点击 I Agree；
  3. 选择安装类型（Select Installation Type）：
    • 界面提供两个选项：Just Me (recommended) 和 All Users；
    • 选择 Just Me，然后点击 Next；
  4. 选择安装路径（Choose Install Location）：
    • 默认路径通常为 C:\Users\用户名\anaconda3；
    • 建议使用不含中文和空格、且自己有写入权限的安装路径。需要更换位置时点击 Browse...，并记下所选路径；
    • 确认磁盘空间充足后（通常需要 5GB 以上可用空间），点击 Next；
  5. 高级安装选项（Advanced Options）：
    • 勾选 Register Anaconda3 as my default Python 3.x（将 Anaconda 注册为系统默认的 Python）；
    • “Add Anaconda3 to my PATH environment variable”可以保持未勾选状态，避免与其他软件冲突；
    • 点击 Install 开始安装；
  6. 等待安装完成：安装所需时间取决于电脑性能。进度条走完后点击 Next，最后在完成界面取消勾选展示教程的复选框，点击 Finish 结束安装。

0.1.3 验证安装

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

案例：通过 Windows 开始菜单启动 Anaconda 终端，查看当前安装的 Conda 与 Python 版本号。

  1. 点击 Windows 任务栏的“开始”菜单；
  2. 在搜索框中输入 Anaconda Prompt；
  3. 打开 Anaconda Prompt，这是用于输入命令的终端窗口；
  4. 在光标闪烁处输入以下命令并按回车键：
    bash 
    conda --version
    若输出类似 conda 24.x.x 的版本信息，说明 Conda 管理器正常；
  5. 继续输入以下命令并按回车键：
    bash 
    python --version
    若输出类似 Python 3.12.x 的版本信息，说明 Python 运行环境安装成功。此时可以关闭该命令行窗口。

0.2 安装 Visual Studio Code

0.2.1 下载安装包

  1. 打开浏览器，访问 VS Code 下载页；
  2. 在 Windows 徽标下方，点击 Windows (User Installer) 按钮下载 64 位安装程序；
  3. 下载得到的安装文件通常名为 VSCodeUserSetup-x64-1.xx.x.exe。

0.2.2 安装步骤

双击下载的安装文件，按照向导完成安装：

  1. 许可协议：选中“我同意此协议”，点击“下一步”；
  2. 安装位置：保持默认路径即可，点击“下一步”；
  3. 开始菜单文件夹：保持默认，点击“下一步”；
  4. 选择附加任务（重要设置）： 在此界面中，建议勾选以下选项：
    • 勾选 创建桌面快捷方式（方便在桌面上快速启动）；
    • 勾选 将“通过 Code 打开”操作添加到 Windows 资源管理器文件上下文菜单；
    • 勾选 将“通过 Code 打开”操作添加到 Windows 资源管理器目录上下文菜单；
    • 勾选 将 Code 注册为受支持的文件类型的编辑器；
    • 勾选 添加到 PATH (重启后生效)（默认已勾选）； 勾选后，点击“下一步”；
  5. 准备安装：点击“安装”按钮，等待进度条走完；
  6. 完成安装：勾选“启动 Visual Studio Code”，点击“完成”。

0.3 VS Code 初始化配置

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

0.3.1 安装简体中文语言包

  1. 打开 VS Code，在左侧边栏找到形状像四个方块的图标（Extensions，快捷键为 Ctrl + 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. 再次点击左侧活动栏的“扩展”图标（或按 Ctrl + Shift + X）；
  2. 在搜索框中输入：Python；
  3. 找到由 Microsoft 官方发布的名为 Python 的插件（带有蓝黄双色 Python 图标）；
  4. 点击 安装（Install）按钮，等待片刻即可安装完成。

0.3.3 选择 Anaconda 的 Python 解释器

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

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

0.4 编写与运行第一个程序

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

0.4.1 新建工作文件夹

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

案例：新建 python_code 文件夹，用它保存课程代码，并在 VS Code 中打开。

  1. 打开电脑的“文件资源管理器”，在自己有写入权限的位置新建文件夹，命名为 python_code；
  2. 打开 VS Code，点击顶部菜单栏的“文件” → “打开文件夹...”；
  3. 找到并选中刚才新建的 python_code 文件夹，点击“选择文件夹”；
  4. 界面会弹出“是否信任此文件夹中的文件的作者”安全确认窗口，点击“是，我信任此作者”。

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!")

输入完毕后，按键盘快捷键 Ctrl + 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 解释器执行文件 → 终端显示输出。

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

第二部分：扩展阅读

在日常使用过程中，可能会遇到一些报错或操作疑问。这里汇总了常见问题的排查方法以及常用的快捷键设置。

0.6 常见问题排查（FAQ）

0.6.1 安装路径中包含中文引发的报错

  • 问题表现：在安装 Anaconda 时提示 Error: Path contains non-ASCII characters，或者安装完成后启动终端报错；
  • 原因说明：Windows 系统的当前用户名为中文字符（如 C:\Users\张三），导致 Anaconda 默认安装路径包含了中文字符。部分开源计算工具对中文路径支持不佳；
  • 解决方法：重新运行安装程序。在“选择安装路径”那一步，点击 Browse... 手动指定安装位置为纯英文路径，例如 C:\anaconda3 或 D:\anaconda3。

0.6.2 PowerShell 提示禁止运行脚本

如果终端提示“无法加载……activate.ps1，因为在此系统上禁止运行脚本”，说明当前执行策略阻止了该脚本。可在与报错终端相同版本的普通 PowerShell 窗口中执行：

案例：为当前用户设置脚本执行策略，使本地环境激活脚本能够运行。

powershell 
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

如出现确认提示，输入 Y 后回车，再重新打开 VS Code 终端。CurrentUser 只针对当前用户，无需为此以管理员身份启动。如果提示设置被组策略覆盖，可查阅 Microsoft 执行策略说明，并按学校设备管理要求处理。

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

  • 问题表现：编辑区右上角没有出现运行按钮，或者右下角弹出提示 Select an Interpreter；
  • 解决方法：
    1. 检查当前文件是否以 .py 结尾，如果保存为 .txt 则不会触发 Python 运行功能；
    2. 按快捷键 Ctrl + Shift + P，输入 Python: Select Interpreter 并回车；
    3. 在弹出的列表中重新点击选择包含 conda 的 Python 路径。

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

0.7.1 开启“自动保存”功能

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

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

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

0.7.2 常用快捷键速查

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

0.8 Conda 基础指令速查

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

案例：在 Anaconda 命令行中查看当前安装的所有 Python 工具库清单。

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

常用基础命令汇总：

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

自行检查

记录所用的 Windows 版本、Anaconda 安装包文件名、python --version 输出和解释器路径。对照官方说明，说明自己为什么选择这个安装包；再修改 hello.py 的输出文字并运行。

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