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

Python 3.12.0 的安装、环境配置与实战准备

以 Python 3.12.0 为例,文章整理了 Windows、macOS、Linux 上的安装步骤、pip 更新、国内镜像源配置和虚拟环境创建与激活方法,也补充了常见报错如 PATH 未配置、权限不足和证书校验失败的处理思路。整体重点不是“装上 Python”,而是把环境一次配顺,后续做项目时少踩依赖和路径的坑。

王者发布于 2026/6/300 浏览
Python 3.12.0 的安装、环境配置与实战准备

Python 3.12.0 的安装、环境配置与实战准备

Python 适合做什么,大家都熟:爬虫、Web、数据分析、机器学习,几乎每个方向都能碰到它。真正开始折腾时,先把版本和环境配好,比急着写代码更省时间。Python 3 已经是默认选择,Python 2 早就该放下了;如果你是新项目,没必要再回头看旧版本。

下面以 Python 3.12.0 为例,按 Windows、macOS、Linux 三个平台分别走一遍安装、配置和常见坑位。内容不花哨,重点是少踩坑。

Windows:安装时先把路径问题解决掉

下载与安装

到官方页面下载:https://www.python.org/downloads/

一般直接选 64 位安装包;如果机器是 ARM 架构,再对应选 ARM64。下载后双击 .exe,第一件事不是点安装,而是勾上 Add Python to PATH。这个选项不勾,后面命令行里找不到 python,排查起来很烦。

接着点 Install Now 就行。要是你想改安装目录,或者顺手装上更多组件,再进 Customize installation。对大多数人来说,默认项够用了。

安装过程中如果看到 Disable path length limit,建议顺手点掉。Windows 的路径长度限制在一些深层依赖里会突然冒出来,提前解除比出错后补救轻松。

验证安装

打开 CMD 或 PowerShell,执行:

python --version

看到 Python 3.12.0 就说明安装成功。再输入 python,如果进入交互式解释器并看到 >>>,说明命令也通了。退出用 exit()。

更新 pip

先把 pip 升一下版本,后面装包少出奇怪问题:

python -m pip install --upgrade pip

配置镜像源

默认的 PyPI 在国外,下载慢是常态。国内开发一般会换镜像源,清华源是比较常见的选择:

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

之后 pip install 就会默认走这个地址。

写第一个脚本

装完之后,可以直接从开始菜单打开 IDLE 试一试,也可以干脆上 VS Code 或 PyCharm。前者够轻,后者更适合长期项目。我个人更倾向于一开始就用编辑器,省得后面再迁移。

macOS:Homebrew 更顺手,DMG 也能用

macOS 常见有两种装法。

方式一:官方 DMG

去官网下载对应的 .dmg,按提示拖拽安装即可。这个方式简单,适合不想碰命令行的人。

方式二:Homebrew

如果你平时就用 Homebrew,直接在终端执行:

brew install [email protected]

这种方式对命令行环境更友好,更新也省事。

检查命令与路径

Homebrew 一般会把环境变量处理好。手动装包的话,可以看一下 PATH 里有没有 /usr/local/bin:

echo $PATH

验证版本时用:

python3 --version

macOS 自带的 Python 往往不是你要的版本,习惯上直接用 python3,别和系统预装的老版本混在一起。

配置 pip 镜像

pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

逻辑和 Windows 一样,只是命令里通常用 pip3。

Linux:优先用包管理器,不够再编译

Linux 上大多数发行版已经带了 Python,但版本通常偏旧。能用包管理器就别急着源码编译,省时也省依赖。

使用系统包管理器

Ubuntu / Debian:

sudo apt update && sudo apt install python3.12 python3-pip

CentOS / RHEL:

sudo yum install python3.12 python3-pip

源码编译

如果系统仓库里没有目标版本,再考虑下载源码包自己编译。流程就是解压后执行 ./configure、make、sudo make install。编译前把 gcc、zlib-dev 之类的依赖装好,不然报错会很碎。

虚拟环境:别把项目依赖搅在一起

真正开始做项目后,最容易乱的不是代码,而是依赖。不同项目装同一个库的不同版本,冲突很常见,所以虚拟环境基本是必选项。

创建环境

在项目目录里执行:

python -m venv myenv

会生成一个 myenv 目录,里面是隔离后的解释器和库。

激活环境

Windows:

myenv\Scripts\activate.bat

macOS / Linux:

source myenv/bin/activate

激活后,命令行前面一般会出现 (myenv)。

导出与恢复依赖

开发到一定阶段,把依赖导出来最稳妥:

pip freeze > requirements.txt

恢复时再执行:

pip install -r requirements.txt

这比手工记版本靠谱得多。

IDE 选择:轻量和完整,按场景选

IDLE 可以用来验证环境,但只适合最初级的尝试。真要写项目,通常还是会落到下面这几个工具:

  1. Visual Studio Code (VS Code):轻量、跨平台,装上 Python 插件和 Pylance 后,补全和调试都够用。
  2. PyCharm:更重,但项目管理能力强,适合中大型工程。
  3. Jupyter Notebook:数据分析、实验性代码、可视化展示都方便。

常见问题:多数都和路径、权限、证书有关

Command 'python' is not recognized

这通常不是 Python 坏了,而是 PATH 没配好,或者装完没有刷新环境变量。先检查安装时有没有勾 Add Python to PATH;没有的话,重新安装或手动把 Python 目录加进 Path。

Permission Denied

Linux 和 macOS 下全局装包时比较常见。解决办法一般有两个:加 --user,或者老老实实进虚拟环境后再装。

pip install --user package

SSL: CERTIFICATE_VERIFY_FAILED

这个报错经常出现在下载包时。先看系统时间是否正确,再升级 pip 和 setuptools。很多时候问题不在包本身,而在本地证书链。

日常习惯:比'能装上'更重要

  • 保持 Python、pip、setuptools 在稳定版本范围内,别长期拖着旧版本。
  • 生产环境里把依赖锁住,用 requirements.txt 或 poetry.lock 固定版本。
  • 定期做依赖安全检查,可以用 pip audit 或 safety。
  • 代码风格尽量贴近 PEP 8,再配合 flake8、pylint 这类工具,很多低级问题能早点暴露。

Python 3.12.0 的安装本身不复杂,真正值得花时间的是环境管理。把路径、pip、镜像源和虚拟环境一次配顺,后面换项目时会轻松很多。

目录

  1. Python 3.12.0 的安装、环境配置与实战准备
  2. Windows:安装时先把路径问题解决掉
  3. 下载与安装
  4. 验证安装
  5. 更新 pip
  6. 配置镜像源
  7. 写第一个脚本
  8. macOS:Homebrew 更顺手,DMG 也能用
  9. 方式一:官方 DMG
  10. 方式二:Homebrew
  11. 检查命令与路径
  12. 配置 pip 镜像
  13. Linux:优先用包管理器,不够再编译
  14. 使用系统包管理器
  15. 源码编译
  16. 虚拟环境:别把项目依赖搅在一起
  17. 创建环境
  18. 激活环境
  19. 导出与恢复依赖
  20. IDE 选择:轻量和完整,按场景选
  21. 常见问题:多数都和路径、权限、证书有关
  22. Command 'python' is not recognized
  23. Permission Denied
  24. SSL: CERTIFICATEVERIFYFAILED
  25. 日常习惯:比“能装上”更重要
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • Spatial Joy 2025 AR/AI 赛事参赛指南
  • Claude 4.6 的 Agent Teams 与 Python 接入思路
  • STM32H743 用定时器触发 ADC 和 DMA 做多通道采样
  • Web 端 3D 开发的实用技术栈梳理
  • Seedance 2.0 实测:AI 视频从“能看”走向“能用”
  • Python 3.11 新特性:性能、异常与类型系统的变化
  • IntelliJ IDEA 2026.1 EAP:Java 26、Spring Boot 4 与 Gradle 9 适配
  • NWPU VHR-10 遥感目标检测与 YOLO 实践
  • 文心一言 4.5:中文能力实测与本地部署记录
  • 在 WSL2 上部署 OpenClaw 的实操记录
  • Vue 3 常用编程技巧整理
  • 在 Ubuntu 22.04 上部署 llama.cpp 和 llama-server
  • Pencil.dev 安装与实战:在 VS Code 里做设计
  • PaddleNLP 3.0:大模型训推一体与多硬件适配实践
  • Unreal Engine 集成 VRM4U 的实战方案
  • 用 LLaMA-Factory WebUI 微调 Qwen2.5-VL
  • Win10 里关闭 Microsoft 365 Copilot 弹窗的几种办法
  • Seedance 2.0 双分支扩散 Transformer 解析
  • Whisper-Large-V3-Turbo 部署与调优笔记
  • 用 OpenClaw 和飞书搭一个 7x24 服务器运维机器人

相关免费在线工具

  • curl 转代码

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

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online