清晰易懂的Python安装与配置教程

初学者也能看懂的 Python 安装与配置教程

本教程将手把手教你安装 Python，并配置国内镜像源和自定义依赖包缓存位置，即使你是零基础小白，也能轻松完成！

一、准备工作

1. 操作系统：Windows 10/11、macOS 或 Linux。
2. 下载工具：浏览器（推荐 Chrome 或 Edge）。
3. 存储空间：至少预留 500MB 可用空间。

二、安装 Python

1. 下载 Python

1. 访问 Python 官网下载页面：https://www.python.org/downloads
2. 选择适合你系统的版本（推荐 Stable Release 的安装包）：
   • Windows：点击 Windows installer (64-bit)
   • macOS：点击 macOS 64-bit universal2 installer
   • Linux：通过系统包管理器安装（如 sudo apt install python3）。

2. 安装 Python（以 Windows 为例）

1. 双击安装包（如 python-3.12.0-amd64.exe）。
2. 勾选 Add Python to PATH（关键步骤！否则需手动配置环境变量）。
3. 选择安装方式：
   • 默认安装：点击 Install Now（安装到 C:\Program Files\Python312）。
   • 自定义安装：点击 Customize installation，可修改安装路径（如 D:\Python）。
4. 等待安装完成，点击 Close。

3. 验证安装

1. 打开命令提示符（Windows：Win + R → 输入 cmd → 回车）。
2. 输入以下命令：

   python --version
   # 输出示例：Python 3.12.0
   pip --version
   # 输出示例：pip 23.3.1 from ... (python 3.12)
   

三、配置 pip 国内镜像源（加速下载）

1. 临时使用国内源

在安装包时直接指定镜像源：

pip install 包名 -i https://pypi.tuna.tsinghua.edu.cn/simple

2. 永久配置国内源（推荐）

Windows 用户

1. 在用户目录下创建 pip 文件夹：
   • 打开文件资源管理器，输入 %APPDATA% 进入此路径。
   • 新建文件夹 pip，进入后新建文件 pip.ini。
2. 用记事本打开 pip.ini，输入以下内容：

   [global]
   index-url = https://pypi.tuna.tsinghua.edu.cn/simple
   trusted-host = pypi.tuna.tsinghua.edu.cn
   

macOS/Linux 用户

1. 创建配置文件：

   mkdir ~/.pip
   nano ~/.pip/pip.conf
   

2. 输入以下内容：

   [global]
   index-url = https://pypi.tuna.tsinghua.edu.cn/simple
   trusted-host = pypi.tuna.tsinghua.edu.cn
   

四、设置 pip 缓存位置（避免占用系统盘）

1. 通过环境变量配置

1. Windows：
   • 右键“此电脑” → 属性 → 高级系统设置 → 环境变量 → 新建系统变量：
     • 变量名：PIP_CACHE_DIR
     • 变量值：自定义路径（如 D:\pip_cache）。
2. macOS/Linux：

   export PIP_CACHE_DIR=/path/to/cache  # 临时生效
   # 永久生效：将上述命令添加到 ~/.bashrc 或 ~/.zshrc
   

2. 验证缓存路径

pip cache dir
# 输出示例：D:\pip_cache

五、编写并运行第一个 Python 程序

1. 创建文件 hello.py，输入以下代码：

   print("你好，世界！")
   

2. 运行程序：

   python hello.py
   # 输出：你好，世界！
   

六、常见问题

1. python 或 pip 命令无效：
   • 检查是否勾选了 Add Python to PATH，或手动添加 Python 安装路径到环境变量。
2. 镜像源不生效：
   • 确保配置文件路径和内容正确（Windows 是 %APPDATA%\pip\pip.ini）。
3. 权限不足（macOS/Linux）：
   • 在命令前加 sudo，或使用虚拟环境（推荐）：

     python -m venv myenv
     source myenv/bin/activate  # macOS/Linux
     myenv\Scripts\activate     # Windows
     

七、总结

通过本教程，你已成功完成以下操作：

1. 安装 Python 并验证环境。
2. 配置 pip 国内镜像源（下载速度提升 10 倍！）。
3. 自定义 pip 缓存位置（解放 C 盘空间）。

接下来可以学习：

• 使用 pip install 安装第三方库（如 requests、numpy）。
• 探索 Python 基础语法和项目实战。

遇到问题欢迎留言讨论，祝你早日成为 Python 高手！ 🐍🚀