初学者也能看懂的 Python 安装与配置教程
本教程将手把手教你安装 Python,并配置国内镜像源和自定义依赖包缓存位置,即使你是零基础小白,也能轻松完成!
一、准备工作
- 操作系统:Windows 10/11、macOS 或 Linux。
- 下载工具:浏览器(推荐 Chrome 或 Edge)。
- 存储空间:至少预留 500MB 可用空间。
二、安装 Python
1. 下载 Python
- 访问 Python 官网下载页面:https://www.python.org/downloads
- 选择适合你系统的版本(推荐 Stable Release 的安装包):
- Windows:点击
Windows installer (64-bit)
- macOS:点击
macOS 64-bit universal2 installer
- Linux:通过系统包管理器安装(如
sudo apt install python3
)。
- Windows:点击
2. 安装 Python(以 Windows 为例)
- 双击安装包(如
python-3.12.0-amd64.exe
)。 - 勾选
Add Python to PATH
(关键步骤!否则需手动配置环境变量)。 - 选择安装方式:
- 默认安装:点击
Install Now
(安装到C:\Program Files\Python312
)。 - 自定义安装:点击
Customize installation
,可修改安装路径(如D:\Python
)。
- 默认安装:点击
- 等待安装完成,点击
Close
。
3. 验证安装
- 打开命令提示符(Windows:
Win + R
→ 输入cmd
→ 回车)。 - 输入以下命令:
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 用户
- 在用户目录下创建
pip
文件夹:- 打开文件资源管理器,输入
%APPDATA%
进入此路径。 - 新建文件夹
pip
,进入后新建文件pip.ini
。
- 打开文件资源管理器,输入
- 用记事本打开
pip.ini
,输入以下内容:[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple trusted-host = pypi.tuna.tsinghua.edu.cn
macOS/Linux 用户
- 创建配置文件:
mkdir ~/.pip nano ~/.pip/pip.conf
- 输入以下内容:
[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple trusted-host = pypi.tuna.tsinghua.edu.cn
四、设置 pip 缓存位置(避免占用系统盘)
1. 通过环境变量配置
- Windows:
- 右键“此电脑” → 属性 → 高级系统设置 → 环境变量 → 新建系统变量:
- 变量名:
PIP_CACHE_DIR
- 变量值:自定义路径(如
D:\pip_cache
)。
- 变量名:
- 右键“此电脑” → 属性 → 高级系统设置 → 环境变量 → 新建系统变量:
- macOS/Linux:
export PIP_CACHE_DIR=/path/to/cache # 临时生效 # 永久生效:将上述命令添加到 ~/.bashrc 或 ~/.zshrc
2. 验证缓存路径
pip cache dir
# 输出示例:D:\pip_cache
五、编写并运行第一个 Python 程序
- 创建文件
hello.py
,输入以下代码:print("你好,世界!")
- 运行程序:
python hello.py # 输出:你好,世界!
六、常见问题
python
或pip
命令无效:- 检查是否勾选了
Add Python to PATH
,或手动添加 Python 安装路径到环境变量。
- 检查是否勾选了
- 镜像源不生效:
- 确保配置文件路径和内容正确(Windows 是
%APPDATA%\pip\pip.ini
)。
- 确保配置文件路径和内容正确(Windows 是
- 权限不足(macOS/Linux):
- 在命令前加
sudo
,或使用虚拟环境(推荐):python -m venv myenv source myenv/bin/activate # macOS/Linux myenv\Scripts\activate # Windows
- 在命令前加
七、总结
通过本教程,你已成功完成以下操作:
- 安装 Python 并验证环境。
- 配置 pip 国内镜像源(下载速度提升 10 倍!)。
- 自定义 pip 缓存位置(解放 C 盘空间)。
接下来可以学习:
- 使用
pip install
安装第三方库(如requests
、numpy
)。 - 探索 Python 基础语法和项目实战。
遇到问题欢迎留言讨论,祝你早日成为 Python 高手! 🐍🚀