Python 开发环境搭建与配置学习笔记

（整理自今日对话，方便后续复习查阅）

---

一、PyCharm 安装与版本管理

1. 完整安装流程

步骤	操作说明	关键注意事项
1	启动安装程序	关闭其他占用文件的应用，避免安装失败
2	卸载旧版本	可选择卸载旧版（如 2021.2.1），勾选「静默卸载」可保留配置
3	安装选项配置	✅ 建议全选：创建桌面快捷方式、添加到 PATH、右键菜单、关联 .py 文件
4	开始菜单文件夹	保持默认 JetBrains 即可，方便后续管理同系列软件
5	安装完成	选择「稍后手动重启」，完成后再重启电脑让配置生效

2. 多版本 PyCharm 管理

• 现象：电脑同时安装了 2023.2.5 与新版本 PyCharm

• 核心规则：环境变量 Path 中靠前的版本优先级更高，系统会优先调用该版本的启动器

• 推荐方案：新手建议保留一个常用版本（优先社区版，永久免费无限制），卸载多余版本避免冲突

---

二、环境变量（Environment Variables）核心知识点

1. 基础概念与作用

• 定义：操作系统的「全局地址簿」，记录软件的可执行文件路径

• 作用：让系统在任意目录下，直接通过命令（如 python）调用软件，无需输入完整路径

• 常见错误：未配置时，系统会提示「不是内部或外部命令」

2. 用户变量 vs 系统变量

类型	作用范围	权限要求	推荐使用场景
用户变量	仅当前登录的 Windows 账号生效	无需管理员权限	Python、PyCharm 等个人开发工具
系统变量	电脑所有用户均生效	需要管理员权限	系统级公共工具（如 JDK、系统命令）

3. 配置步骤（以 Python 为例）

1. 打开：Win 键搜索「环境变量」→ 点击「编辑系统环境变量」→ 打开「环境变量」设置窗口

2. 修改：在上方「用户变量」中找到 Path，双击进入编辑界面

3. 添加路径：

   • Python 主目录：C:\Users\你的用户名\AppData\Local\Programs\Python\Python310

   • Python Scripts 目录：C:\Users\你的用户名\AppData\Local\Programs\Python\Python310\Scripts

   • PyCharm bin 目录：C:\heima\software\PyCharm 2023.2.5\bin

4. 生效：点击「确定」保存，必须重启 CMD 窗口，新配置才会被加载

---

三、Launcher（启动器）详解

1. 基础概念

Launcher 是软件的「轻量启动程序」（通常为 .exe 文件），负责定位主程序并完成启动前的简单配置。

2. 与你相关的两类 Launcher

（1）Python Launcher（py.exe）

• 核心作用：解决多版本 Python 共存时的调用混乱问题

• 实用命令：

  
  py --version          # 查看默认 Python 版本
  py -3.8               # 精准启动 Python 3.8
  py -3.10              # 精准启动 Python 3.10
  py -m pip install xxx # 为指定版本安装第三方库
  

（2）PyCharm Launcher（pycharm64.exe）

• 位置：PyCharm 安装目录的 bin 文件夹内

• 配置意义：将 bin 目录添加到环境变量后，可直接在 CMD 中输入 pycharm 启动软件

---

四、今日关键问题与解决方案

1. 问题：Path 中 %PyCharm% 无效

• 原因：%变量名% 的引用格式，需要先在用户变量中定义该变量，否则系统无法识别

• 解决方案：

  • 推荐：直接替换为 PyCharm bin 目录的绝对路径（如 C:\heima\software\PyCharm 2023.2.5\bin），无需额外配置

  • 可选：先在用户变量中新建变量 PyCharm，赋值为 bin 目录路径，再在 Path 中引用 %PyCharm%（不推荐，增加复杂度）

2. 问题：多版本 Python 调用混乱

• 原因：Path 中多个 Python 路径同时存在，系统按顺序查找，可能调用到非预期版本

• 解决方案：

  • 调整 Path 中路径顺序，将常用版本的路径上移，设置为默认版本

  • 优先使用 py -3.x 命令精准指定版本，无需频繁修改 Path

3. 问题：配置环境变量后命令仍不生效

• 排查步骤：

  1. 确认路径格式正确，无拼写错误、无中文/空格路径

  2. 关闭所有已打开的 CMD 窗口，重新打开后再测试

  3. 检查是否有多个版本的软件路径冲突，可调整 Path 顺序

---

五、当前环境状态总结

• ✅ Python 环境：3.8 与 3.10 路径已配置，Launcher 正常生效

• ❌ PyCharm 环境：Path 中 %PyCharm% 需替换为绝对路径

• 最终验证：修改后重启 CMD，输入 python --version 和 pycharm，均正常响应即为配置完成

---

补充：后续复习建议，可重点记忆「环境变量配置步骤」「用户变量与系统变量区别」「Launcher 实用命令」，这三部分是开发环境搭建的核心基础。