Python官网(https://www.python.org)是获取官方安装包的唯一权威渠道。进入官网后,点击顶部导航栏的Downloads,页面将自动识别您的操作系统并推荐最新稳定版本(如Python 3.12.3)。但不建议盲目使用推荐版本,需根据项目需求选择:
• 3.x系列:主流版本,支持现代语法(f-string、async/await等),2020年起停止Python 2.x维护
• 3.11+版本:性能提升显著(平均快25%),但部分旧库(如早期Django)可能存在兼容性问题
• 3.8-3.10:企业级应用最广泛,稳定性高,适合生产环境部署
下载页面提供两类安装包:
• Windows安装包:.exe格式(推荐“Windows installer”),含完整安装向导
• macOS安装包:.pkg格式,安装过程与普通应用一致
• Linux用户:建议通过包管理器安装(如Ubuntu用sudo apt install python3),避免源码编译
双击运行.exe安装包后,务必勾选底部的✅ Add Python to PATH(关键步骤!),否则后续无法在命令行直接调用python命令。
安装模式选择:
• Standard Installation:默认路径(C:\Users\用户名\AppData\Local\Programs\Python\Python3xx),适合新手
• Customize Installation:需手动配置:
- Install for all users(勾选后安装至C:\Program Files\Python3xx)
- Associate files with Python(自动关联.py文件)
- Create shortcuts(桌面/开始菜单快捷方式)
- Precompile standard library(预编译标准库,首次运行更快)
典型错误场景:未勾选Add Python to PATH导致安装后打开CMD输入python提示“'python' 不是内部或外部命令”
macOS自带Python 2.7(已废弃),安装新版本后需手动调整路径:
1. 安装完成后,打开终端执行:
echo 'export PATH="/Library/Frameworks/Python.framework/Versions/3.12/bin:$PATH"' >> ~/.zshrc
2. 重新加载配置:
source ~/.zshrc
3. 验证:python3 --version应显示新版本号
特别提醒:避免使用sudo安装Python(如sudo pip install),可能导致系统文件损坏。推荐使用pyenv管理多版本:
brew install pyenv && pyenv install 3.12.3 && pyenv global 3.12.3
| 发行版 | 安装命令 | 注意事项 |
|---|---|---|
| Ubuntu/Debian | sudo apt update && sudo apt install python3 python3-pip | 使用python3命令调用 |
| CentOS/RHEL | sudo yum install python3 python3-pip | 需启用EPEL源 |
| Fedora | sudo dnf install python3 python3-pip | 默认使用python3 |
源码编译方案(仅高级用户):
wget https://www.python.org/ftp/python/3.12.3/Python-3.12.3.tgz && tar xzf Python-3.12.3.tgz && cd Python-3.12.3 && ./configure --enable-optimizations && make -j$(nproc) && sudo make altinstall
安装后通过python3.12调用,避免覆盖系统默认Python
Windows诊断步骤:
1. 按Win+R输入cmd打开命令提示符
2. 输入where python,若无输出说明PATH未配置
3. 解决方案:
- 重新安装并勾选Add Python to PATH
- 手动添加环境变量:
`系统属性 → 高级 → 环境变量 → 用户变量 → Path → 新建 → 添加Python安装目录(如C:\Python312)`
`同时添加Scripts目录(如C:\Python312\Scripts)`
macOS/Linux诊断:
1. 执行which python3查看路径
2. 若返回空值,检查~/.zshrc或~/.bashrc中PATH配置
3. 修复后执行source ~/.zshrc生效
根本原因:未关联Python解释器或脚本存在错误
Windows修复方案:
1. 右键任意.py文件 → 打开方式 → 选择其他应用
2. 勾选始终使用此应用打开.py文件
3. 浏览至Python安装目录下的python.exe(通常位于C:\Users\用户名\AppData\Local\Programs\Python\Python3xx\python.exe)
脚本调试技巧:
• 在脚本末尾添加input("按回车退出...")防止窗口自动关闭
• 用IDLE(安装时自带)打开脚本,按F5运行查看完整错误信息
• 使用python -u script.py强制不缓冲输出流
常见现象:
• python --version显示Python 2.7.18(系统自带旧版)
• python3 --version显示新版本但pip命令失效
解决方案:
1. 检查安装路径:where python(Windows)或which python(Linux/macOS)
2. 多版本共存处理:
- Windows:使用py -3.12指定版本
- Linux/macOS:通过python3.12调用具体版本
3. 修复pip关联:
python -m ensurepip --upgrade
python -m pip install --upgrade pip
浏览器安全限制:
Chrome/Firefox可能拦截.exe文件,需点击地址栏右侧的🔒图标 → 允许下载
文件完整性校验(防篡改):
1. 下载官网提供的SHA256校验值(如Python-3.12.3-amd64.exe.sha256)
2. Windows执行:
certutil -hashfile Python-3.12.3-amd64.exe SHA256
3. macOS/Linux执行:
shasum -a 256 Python-3.12.3-macos11.pkg
对比输出值与官网校验值是否一致
环境变量是操作系统识别程序路径的“地图”。当输入python命令时,系统按PATH变量顺序搜索可执行文件:
C:\Windows\System32 → C:\Python312 → C:\Program Files\Python312\Scripts
关键目录说明:
• Python根目录:包含python.exe(解释器主程序)
• Scripts子目录:包含pip.exe、django-admin.exe等工具
• Lib目录:标准库源码路径(如os.py、sys.py)
Windows环境变量设置:
1. 打开系统属性 → 高级 → 环境变量
2. 在用户变量区点击New添加:
- 变量名:PYTHONPATH
- 变量值:C:\Projects\MyLibs(自定义模块搜索路径)
3. 修改PATH变量:
- 删除重复条目(如旧版Python路径)
- 确保新路径位于系统路径之前(避免版本冲突)
Linux/macOS配置:
在~/.bashrc或~/.zshrc中添加:
export PYTHONPATH="/home/user/projects/lib:$PYTHONPATH"
export PATH="/opt/python/bin:$PATH"
保存后执行source ~/.zshrc使配置生效
虚拟环境必要性:
• 避免项目依赖冲突(如Django 3.x与4.x)
• 保障系统Python环境纯净
• 满足CI/CD环境可复现需求
venv创建流程:
1. 创建环境:
python -m venv myproject_env
2. 激活环境:
- Windows:myproject_env\Scripts\activate
- Linux/macOS:source myproject_env/bin/activate
3. 退出环境:deactivate
pip依赖管理:
• 导出依赖:pip freeze > requirements.txt
• 安装依赖:pip install -r requirements.txt
• 依赖清理(避免残留):
pip uninstall -r requirements.txt -y
pyenv安装与使用:
1. 安装:
- Windows:choco install pyenv(需先安装Chocolatey)
- macOS:brew install pyenv
- Linux:curl https://pyenv.run | bash
2. 安装指定版本:
pyenv install 3.10.12
3. 全局切换:
pyenv global 3.10.12
4. 项目局部指定:
cd myproject && pyenv local 3.10.12
自动创建.python-version文件
步骤1:检查安装成功
在CMD输入:
python --version → 应显示Python 3.12.3
pip --version → 应显示pip 24.0 from ...\site-packages\pip (python 3.12)
步骤2:创建第一个脚本
1. 新建文本文件,命名为hello.py
2. 输入内容:
print("Hello, Python!\n欢迎来到Python世界!")
3. 保存后双击运行(若闪退,改用CMD执行python hello.py)
步骤3:交互式调试
1. 打开CMD输入python进入交互模式
2. 输入import this查看Python之禅
3. 测试基本运算:2 ** 10 → 显示1024
问题复现:
终端输入python提示command not found
输入python3显示Python 3.9.6(系统版本)
解决方案:
1. 创建软链接:
ln -s /Library/Frameworks/Python.framework/Versions/3.12/bin/python3 /usr/local/bin/python
2. 验证:
which python → 应返回/usr/local/bin/python
python --version → 显示Python 3.12.3
验证pip安装:
python -m pip install requests
python -c "import requests; print(requests.__version__)"
Linux/macOS执行权限错误:
直接运行./script.py提示Permission denied
解决方案:
1. 添加执行权限:
chmod +x script.py
2. 在脚本首行添加shebang:
#!/usr/bin/env python3
3. 设置PATH包含当前目录:
export PATH=".:$PATH"
现在可直接执行./script.py
Ctrl+Shift+P → Python: Select Interpreter"python.formatting.provider": "black""editor.formatOnSave": trueNew environment using venvPython Integrated Tools → Formatting → BlackProject Structure添加源码根目录pip install jupyterlabjupyter lab(自动打开浏览器)jupyter lab --generate-configc.NotebookApp.notebook_dir问题现象:
• 下载过程中断,显示连接超时
• 下载的.exe文件大小仅为几KB
解决方案:
1. 更换下载源:
- 使用国内镜像:清华大学镜像站
- 命令:wget https://mirrors.tuna.tsinghua.edu.cn/python/3.12.3/python-3.12.3-amd64.exe
2. 代理设置:
- 在浏览器中安装SwitchyOmega,配置代理服务器
3. 离线安装包:
- 下载embeddable zip file(无需安装,解压即用)
问题背景:
Python 3.9+已停止支持32位Windows系统
解决方案:
1. 下载Python 3.8.10(最后支持32位的版本):
https://www.python.org/downloads/release/python-3810/
2. 或升级硬件:更换64位CPU(2010年后设备基本支持)
3. 使用Web版:Replit在线编程(免安装)
典型症状:
• 安装时卡在Compiling Python modules...
• pip安装包时长时间无响应
解决步骤:
1. 关闭Windows Defender实时保护:
设置 → 更新与安全 → Windows安全中心 → 病毒和威胁防护 → 管理设置 → 关闭实时保护
2. 将Python目录加入白名单:
C:\Users\用户名\AppData\Local\Programs\Python\Python3xx
3. 使用命令行安装:
python -m pip install --no-cache-dir 包名
现象:
• 脚本中含中文注释报错SyntaxError: Non-ASCII character
• CMD窗口显示乱码
解决方案:
1. 文件编码声明:
在脚本首行添加:
# -*- coding: utf-8 -*-
2. Windows CMD编码设置:
chcp 65001(切换到UTF-8)
reg add HKCU\Console /v CodePage /t REG_DWORD /d 65001(永久生效)
3. 使用IDLE或VS Code等现代编辑器(默认UTF-8)
Python文件处理能力:
• 文本文件:.txt/.csv/.json
with open('data.json', 'r', encoding='utf-8') as f: data = json.load(f)
• Excel文件:.xlsx(需pandas库)
df = pd.read_excel('sales.xlsx')
• 图片文件:.png/.jpg(需PIL库)
img = Image.open('photo.jpg').convert('L')
• 压缩包:.zip/.7z(需zipfile模块)
with zipfile.ZipFile('archive.zip') as zf: zf.extractall('output')
• 数据库文件:.sqlite(内置sqlite3模块)
conn = sqlite3.connect('test.db')
注意:Python本身不直接“打开”二进制文件,而是通过库解析其内容结构。例如PDF需使用PyPDF2库提取文本,而非直接显示页面。
| 平台 | 特点 | 推荐课程 |
|---|---|---|
| 廖雪峰Python教程 | 循序渐进,适合零基础 | Python教程 |
| Real Python | 实战项目导向 | Python Tutorials |
| 菜鸟教程 | 简洁快速入门 | Python3 教程 |
pandas:数据表格处理(类似Excel)numpy:高性能数值计算matplotlib:数据可视化openpyxl:Excel文件操作Flask:轻量级框架(适合小型应用)Django:全功能框架(含ORM、认证等)FastAPI:现代异步框架(API开发首选)selenium:浏览器自动化schedule:定时任务pyautogui:鼠标键盘控制