Win的Python环境配置

写在最前

本学期正式开始学习计算机基础课程（26-27-fi），重新在我的 Mac 上配置 Python 环境。我的环境配置思路是：VS Code + Miniconda + Git（后期链接 Github 项目），写下这个教程，也帮助各位同学配置 Python 环境。如果你是 Mac 系统，请访问这个链接： Mac 的 Python 环境配置

注意：

由于笔者是 Mac，所以 Windows 系统的安装方法是 GPT 写的。如果在安装过程中出现各类问题，可以随时联系笔者，线上指导或者线下安装。

前置知识

一些你需要提前知道的。

VS Code

Visual Studio Code（简称 VS Code）是由 Microsoft 开发的一款跨平台源代码编辑器，支持 Windows、macOS 和 Linux 操作系统。

VS Code 提供了许多现代编辑器应具备的功能，包括语法高亮、可定制的快捷键绑定、括号匹配和代码片段收集。此外，它还内置了对 Git 的支持，方便开发者进行版本控制。

VS Code 支持多种编程语言和文件格式，如 JavaScript、TypeScript、Node.js、C++、C#、Java、Python、PHP、Go 等。

Miniconda

Miniconda 是一个轻量级的 Python 发行版，专注于提供最基本的功能，包括 Python 和 Conda 包管理工具，以及它们的必要依赖项。它是 Anaconda 的简化版本，适合对存储空间要求较高或只需要基础功能的用户。

并且，Anaconda 是图形化管理界面，而 Miniconda 是命令行管理，看起来 Miniconda 会比较帅气。完整体的 Anaconda 足足有 5 GB 大小，我们不需要那么大。

Git

**Git ** 是一个开源的分布式版本控制系统，它能够高效地处理从小到大的项目。 Git 是由 Linus Torvalds 创建的，最初的目的是为了更好地管理 Linux 内核的开发。笔者在这里有管理 Github 项目的需求，所以顺手配置了。

安装过程

完整的安装过程。

1. 安装 Miniconda

在 Miniconda 官网下载 Windows 安装包，双击运行。

安装时：

• 选择 Just Me（仅当前用户）。

• 安装目录尽量避免中文和空格，记下实际路径。

• 保留 Create shortcuts。

• 不要勾选 Add Miniconda3 to my PATH environment variable，避免与其他软件的 Python、运行库冲突。

• Register Miniconda3 as my default Python 可不勾选，后面在 VS Code 中手动指定解释器。它不等同于添加 PATH。

  官方安装说明

安装完成后，在开始菜单打开 Anaconda Prompt（Miniconda3），检查：

conda --version

2. 配置环境变量与终端（重点）

推荐让 Conda 管理环境变量，不要手动把安装目录、Scripts、Library\bin 全部加入系统 PATH。

在 Anaconda Prompt 中执行：

conda init powershell

然后关闭所有 PowerShell 窗口，并完全退出、重新打开 VS Code。初始化后，PowerShell 才能正确使用 conda activate。Conda 官方说明

注意：

• 不需要额外创建 PYTHONHOME、PYTHONPATH 环境变量。
• conda activate 会为当前终端配置对应环境的 PATH。
• 如果只使用 Anaconda Prompt，无须额外初始化或手动修改 PATH。

如果确实需要在未初始化的普通终端中找到 conda，可以按以下方式添加入口：

搜索“编辑系统环境变量” → 环境变量 → 上方“用户变量”中的 Path → 编辑 → 新建

添加：

实际安装目录\conda\bin

例如：

C:\Users\你的用户名\miniconda3\conda\bin

只新增这一项，不要覆盖原有 Path，也不要添加到“系统变量”。 保存后重新打开终端。仅添加此路径不等于完成 PowerShell 初始化，仍需执行前面的 conda init powershell。

3. 创建 Python 环境

在 Anaconda Prompt 中逐行执行：

conda create -n pydev python=3.12 pip
conda activate pydev
python --version

询问是否继续时输入 y。这里以 Python 3.12 为例，有项目版本要求时按要求替换。

4. 安装 VS Code

从 VS Code 官网下载 Windows User Installer，运行安装程序。

安装时保留 Add to PATH（添加到 PATH），这样终端就能使用 code 命令。安装后重开终端，执行：

code --version

VS Code 可以添加 PATH；Miniconda 不建议整体添加 PATH，两者不要混淆。官方安装说明

5. 连接 Python 环境并验证

1. 打开 VS Code，在扩展中安装 Microsoft 发布的 Python；使用 Notebook 时再安装 Jupyter。
2. 打开项目文件夹，按 Ctrl + Shift + P。
3. 搜索 Python: Select Interpreter，选择 pydev。
4. 若没有找到，手动选择：

实际安装目录\envs\pydev\python.exe

新建 test.py：

import sys
print(sys.executable)
print("Python 环境安装成功")

点击 Run Python File in Terminal。输出的解释器路径包含 envs\pydev\python.exe，即配置完成。

总结

到此，你已经完成的全部的环境配置，祝你后面学习愉快。注意：安装过程中遇到任何问题，可以与笔者随时联系，线上指导或者线下安装。