跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonAI算法

Python 开发环境搭建指南:从安装到配置

详细介绍在 Windows、macOS 和 Linux 系统上安装 Python 解释器的步骤,包括环境变量配置、包管理器 pip 的使用以及集成开发环境 VS Code 的安装与插件配置。内容涵盖虚拟环境创建及常见问题的排查方法,旨在帮助开发者快速搭建稳定高效的 Python 开发工作流。

CloudNative发布于 2025/2/6更新于 2026/5/2818 浏览
Python 开发环境搭建指南:从安装到配置

Python 开发环境搭建指南

前言

要开始编写 Python 代码,首先需要下载和安装 Python 解释器。本文详细介绍了在 Windows、macOS 和 Linux 系统上安装 Python 的步骤,包括环境变量配置、包管理器使用以及集成开发环境的设置。

1. 下载与安装 Python 解释器

1.1 Windows 系统

  1. 访问 Python 官方网站 (https://www.python.org) 并进入 Downloads 页面。
  2. 选择最新的稳定版本(如 Python 3.x),点击对应的 Download 链接。
  3. 运行安装程序。重要:在安装向导中务必勾选 "Add Python to PATH"。
  4. 选择 "Customize installation" 以确认组件,通常默认选项即可满足需求。
  5. 完成安装后,打开命令提示符 (cmd),输入 python --version 验证。

1.2 macOS 系统

  1. 访问 Python 官网下载 macOS 安装包 (.pkg)。
  2. 双击安装包并按照向导完成安装。
  3. 或者使用 Homebrew 安装:
    brew install python
    
  4. 验证安装:
    python3 --version
    

1.3 Linux 系统

大多数 Linux 发行版预装了 Python,但建议安装最新版本。

  1. 检查当前版本:
    python3 --version
    
  2. 若未安装或版本过低,使用包管理器安装:
    # Ubuntu/Debian
    sudo apt update
    sudo apt install python3 python3-pip
    
    # CentOS/RHEL
    sudo yum install python3 python3-pip
    
  3. 验证安装是否成功。

2. 配置环境变量

为了在任意目录使用 Python 命令,需将 Python 路径添加到系统环境变量 PATH 中。

Windows

  1. 右键点击 "此电脑" -> "属性" -> "高级系统设置" -> "环境变量"。
  2. 在 "系统变量" 中找到 "Path",点击 "编辑"。
  3. 添加 Python 安装路径(例如 C:\Python39\)及 Scripts 路径(例如 C:\Python39\Scripts\)。
  4. 保存后重启终端生效。

macOS / Linux

  1. 编辑 shell 配置文件(如 ~/.bashrc, ~/.zshrc)。
  2. 添加以下行:
    export PATH=$PATH:/usr/local/bin/python3
    
  3. 使配置生效:
     ~/.bashrc
    
source

3. 包管理与虚拟环境

3.1 pip 包管理器

pip 是 Python 的标准包管理工具。

  • 升级 pip:
    python -m pip install --upgrade pip
    
  • 安装第三方库:
    pip install requests
    

3.2 创建虚拟环境

为避免依赖冲突,建议使用虚拟环境。

# 创建虚拟环境
python -m venv myenv

# 激活虚拟环境
# Windows
myenv\Scripts\activate
# Linux/macOS
source myenv/bin/activate

激活后命令行前会显示 (myenv) 标识。

4. 集成开发环境 (IDE) 配置

推荐使用 Visual Studio Code (VS Code),轻量且功能强大。

4.1 安装 VS Code

  • Windows: 下载安装包运行安装。
  • Linux: 通过终端安装(以 Ubuntu 为例):
    wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
    sudo mv microsoft.gpg /etc/apt/trusted.gpg.d/microsoft.gpg
    echo "deb [arch=amd64] https://packages.microsoft.com/repos/vscode stable main" | sudo tee /etc/apt/sources.list.d/vscode.list
    sudo apt update
    sudo apt install code
    

4.2 配置 Python 插件

  1. 打开 VS Code,点击左侧扩展图标 (Ctrl+Shift+X)。
  2. 搜索 "Python" 并安装官方插件。
  3. 重新加载窗口。
  4. 打开项目文件夹,VS Code 会自动检测 Python 解释器。
  5. 按 F1 输入 Python: Select Interpreter 选择对应环境。

5. 最佳实践与常见问题

  • 依赖管理: 使用 requirements.txt 记录依赖。
    pip freeze > requirements.txt
    pip install -r requirements.txt
    
  • 编码规范: 遵循 PEP 8 风格指南。
  • 常见错误:
    • command not found: 检查环境变量是否配置正确。
    • Permission denied: 尝试使用 sudo 或在虚拟环境中操作。
    • ssl error: 确保系统证书已更新。

结语

通过以上步骤,您已成功搭建 Python 开发环境。无论是进行数据分析、Web 开发还是人工智能研究,一个良好的环境都是高效工作的基础。

目录

  1. Python 开发环境搭建指南
  2. 前言
  3. 1. 下载与安装 Python 解释器
  4. 1.1 Windows 系统
  5. 1.2 macOS 系统
  6. 1.3 Linux 系统
  7. Ubuntu/Debian
  8. CentOS/RHEL
  9. 2. 配置环境变量
  10. Windows
  11. macOS / Linux
  12. 3. 包管理与虚拟环境
  13. 3.1 pip 包管理器
  14. 3.2 创建虚拟环境
  15. 创建虚拟环境
  16. 激活虚拟环境
  17. Windows
  18. Linux/macOS
  19. 4. 集成开发环境 (IDE) 配置
  20. 4.1 安装 VS Code
  21. 4.2 配置 Python 插件
  22. 5. 最佳实践与常见问题
  23. 结语
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • 机器人 URDF 建模与 Isaac Sim 仿真集成指南
  • Windows 11 本地部署 OpenClaw 实操:集成 Telegram 机器人与网页搜索能力
  • 异构算力驱动 AIGC:通义万相 2.1 文生图模型部署与特性解析
  • Python 列表基础与常用操作详解
  • 职业低谷期的自我提升:Python 全栈学习路线与技能进阶
  • 字节跳动豆包大模型:全模态架构与普惠化路径
  • 互联网大厂算法工程师面试题汇总与核心原理解析
  • 大模型技术演进与未来办公形态变革分析
  • 入职未满三年的工作总结与经验复盘
  • 用 Prompt 生成正则表达式进行文本匹配实战指南
  • Python 从入门到精通:核心语法、爬虫与深度学习实战指南
  • 2026 年起无人机“黑飞”入法:违规飞行或面临拘留
  • AD4630 四通道 SPI 模式配置与采集 FPGA 设计
  • AIGC 技术解析:人工智能生成内容的现状与未来
  • WebStorm 安装与首次启动配置教程
  • RAG 落地与知识管理:构建新的知识运营体系
  • LLM 基础知识备忘录
  • FPGA 入门教程:基于 Quartus 的 LED 点亮流程
  • Python 网络爬虫实战:采集附近店铺信息并保存至 CSV
  • 前端地图开发基础:服务类型、坐标系与 SDK 简介

相关免费在线工具

  • 加密/解密文本

    使用加密算法(如AES、TripleDES、Rabbit或RC4)加密和解密文本明文。 在线工具,加密/解密文本在线工具,online

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Gemini 图片去水印

    基于开源反向 Alpha 混合算法去除 Gemini/Nano Banana 图片水印,支持批量处理与下载。 在线工具,Gemini 图片去水印在线工具,online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online