查看: 243|回复: 3

Python 3.12环境搭建:PATH、pip镜像与脚本运

[复制链接]
发表于 2 小时前 | 显示全部楼层 |阅读模式
搭建 Python 运行环境是开发自动化脚本的第一道门槛:装得不对,后面装库、跑脚本都会卡在同一个地方。本文以 Windows 11 + Python 3.12.9 为例,把版本选择、安装勾选项、PATH 配置、pip 装库和脚本执行串成一条可复现的流程,并给出三个高频问题的排查办法。示例选用 cantools 作为验证库,它用于解析 CAN DBC 文件,是 CAN 通信开发中替代手工逐条配置信号的常用工具,也正好用来检验环境是否可用。

一、版本与安装包怎么选

Python 官网下载页为 https://www.python.org/downloads/,免费开源,无需 license。Windows 11 下兼顾稳定性和兼容性,推荐 3.12.x(例如 3.12.9);想尝鲜可以选 3.13.x。需要注意,3.12.9 不支持 Windows 7 及更早版本,Win11 用户不受影响。

按系统位数选安装包:
  1. - Windows 11 64 位(绝大多数):Windows installer (64-bit)
  2. - 老旧 32 位系统:Windows installer (32-bit)
  3. - ARM 芯片笔记本(少见):Windows installer (ARM64)
复制代码

不确定位数时,按 Win + I 打开设置,进入“系统 → 关于”,查看“系统类型”,显示“64 位操作系统”就选 64-bit 包。

二、安装过程中最关键的两个动作

双击 .exe 后,安装向导里有两处容易漏掉,直接影响后续能否在命令行直接调用 python:

1. 首页先勾选最下面的两个选项,其中“Add python.exe to PATH”必须勾上,否则会出现后文的“不是内部或外部命令”。
2. 点“Customize installation”进入自定义安装,不要点“Install Now”。后者是一键装到 C 盘用户目录,路径不可控。

组件页保持默认勾选后点“Next”。在高级选项页先改安装路径,默认路径形如 C:\Users\你的用户名\AppData\Local\Programs\Python\Python312,建议改为 D:\Python312 这类短路径,再确认以下选项全部勾选:
  1. ☑ Install for all users
  2. ☑ Associate files with Python
  3. ☑ Create shortcuts
  4. ☑ Add Python to environment variables
  5. ☑ Precompile standard library
复制代码

然后点“Install”。安装完成后,向导末尾会出现“Disable path length limit”,务必点击,解除 Windows 260 字符的路径长度限制——深层依赖目录在装库时很容易触碰这个上限。最后点 Close 结束。

三、验证是否装好

按 Win + R 输入 cmd 打开命令提示符,执行:
  1. python --version
复制代码

输出 Python 3.12.9 即表示安装与 PATH 配置生效。

四、pip 与第三方库

pip 是 Python 的包管理工具,用于安装第三方库。升级 pip 是可选项,不升级也能正常使用:
  1. python.exe -m pip install --upgrade pip
复制代码

以安装 cantools(CAN DBC 解析库)为例:
  1. pip install cantools
复制代码

成功时提示 Successfully installed cantools-xx.x.x ...,同时会带出一批依赖包。查看当前环境已安装的库:
  1. pip list
复制代码

输出示例:
  1. Package            Version
  2. ------------------ -------
  3. argparse-addons    0.12.0
  4. bitstruct          8.22.1
  5. cantools           41.4.3
  6. crccheck           1.3.1
  7. pip                24.3.1
  8. python-can         4.6.1
  9. textparser         0.24.0
  10. typing_extensions  4.15.0
  11. wrapt              1.17.3
复制代码

从依赖列表可以看出,cantools 建立在 bitstruct、python-can、textparser 等包之上,这也是为什么直接 pip 安装比手工逐个装依赖更稳妥。

五、运行第一个脚本

在桌面新建文本文件,改名为 hello.py(扩展名必须是 .py),用记事本写入:
  1. print("Hello, Python!")
复制代码

保存后在 cmd 中切换到脚本所在目录,执行:
  1. python hello.py
复制代码

输出 Hello, Python! 说明解释器、PATH 和脚本文件三者都正常。

也可以使用安装包自带的 IDLE:按 Win 键搜索 IDLE,打开“IDLE (Python 3.12 64-bit)”,注意不要选错成其他同名程序;在 File → New File 新建文件并编写代码,按 F5 运行即可看到结果。

六、三个常见问题的定位与解决

Q1:执行 python --version 提示“不是内部或外部命令”
原因:安装时没有勾选“Add python.exe to PATH”,系统找不到解释器。
解决:重新运行安装程序勾选该选项,或手动把 Python 安装目录及其 Scripts 子目录加入环境变量。

Q2:安装时提示“需要管理员权限”
解决:右键安装包,选择“以管理员身份运行”。

Q3:pip install 下载很慢或超时
解决:临时指定国内镜像源,例如:
  1. pip install cantools -i https://pypi.tuna.tsinghua.edu.cn/simple
复制代码

七、适用场景与后续

走完以上步骤后,机器具备的能力包括:Python 3.12 的下载安装、PATH 环境变量生效、pip 包管理可用、脚本能从命令行或 IDLE 运行。对自动化脚本类需求(例如用 Python + cantools 自动读取 DBC 并生成 CAN 配置代码)来说,这一步是必要前置;后续只需要在同一个环境里继续 pip 安装业务依赖、按模块拆分脚本即可。
回复

使用道具 举报

发表于 2 小时前 | 显示全部楼层

Re: Python 3.12环境搭建:PATH、pip镜像与脚本运

流程写得很完整,尤其是把 PATH 和“Disable path length limit”单独拎出来提醒,这两点确实最容易在第二天装库时突然爆出来。补充几个我自己的习惯,给后面照着做的人少踩点坑: 装完先 `python --version` 和 `where python` 一起看,能确认命中的到底是哪个解释器。机器上以前装过 Anaconda 或其他 Python 的话,PATH 里谁排在前面很关键,不然 version 对了但 pip 装到别处去,装完 cantools 在脚本里 import 不到,很容易怀疑人生。 另外我一般不用裸的 `pip install`,而是统一写成 `python -m pip install xxx`,这样装到当前 `python` 对应的那个环境里,多版本共存时更不容易串。升级 pip 也一样,楼主写的 `python.exe -m pip install --upgrade pip` 其实就是这个思路。 还有个小建议:真正开始写自动化脚本之后,一个项目一个虚拟环境会省很多事,`python -m venv .venv` 然后在项目目录里激活,装业务依赖都装在里面,系统环境保持干净。不过作为“第一道门槛”的验证,按楼主这套先跑通 hello.py 和 cantools 完全够用了。 Q3 的镜像源那段也实用,临时加 `-i` 比直接改全局配
回复 支持 反对

使用道具 举报

发表于 2 小时前 | 显示全部楼层

Re: Python 3.12环境搭建:PATH、pip镜像与脚本运

感谢分享,流程写得很细,特别是“Add python.exe to PATH”和 Disable path length limit 这两处,确实是最容易踩坑的地方。我自己装的时候也遇到过命令行找不到 python 的情况,后来就是重新运行安装包补勾了 PATH 才解决。 补充几个小经验供参考: 一是关于 PATH,除了安装目录本身,Scripts 子目录也要加进去,否则 pip 装的一些命令行工具可能调不到。安装时勾选“Add Python to environment variables”一般会自动处理,但手动配的时候容易漏。 二是建议养成用 python -m pip 代替直接 pip 的习惯,尤其是机器上装了多个 Python 版本时,能确保装到当前解释器对应的环境里,和文中升级 pip 的写法一致。 三是如果后面要长期做自动化脚本,可以顺手了解一下 venv 虚拟环境,把 cantools 这类业务依赖装在项目自己的环境里,避免不同项目的依赖版本互相打架。文中验证环境用 hello.py 加 cantools 两步走挺稳妥的,先确认解释器通,再确认装库通。 另外 Q3 的镜像源,如果经常装库,也可以把清华源配置成默认,省得每次手动加 -i 参数。不过临时指定确实更省事,适合偶尔用。 整体照着做应该能一次跑通,收藏了。
回复 支持 反对

使用道具 举报

发表于 2 小时前 | 显示全部楼层

Re: Python 3.12环境搭建:PATH、pip镜像与脚本运

这篇整理得很细,流程也顺,适合照着一步步做。尤其几个容易踩坑的点提醒得到位:安装首页必须勾选 Add python.exe to PATH、不要直接点 Install Now、安装路径尽量短,以及最后解除路径长度限制,这些都是后面装库和跑脚本时很容易出问题的地方。 验证部分也实用,先用 python --version 确认解释器,再用 pip install cantools 和 pip list 检查依赖,最后跑 hello.py 串起完整链路,排查思路很清楚。Q1 到 Q3 基本覆盖了新手最常见的卡点,镜像源那条对国内网络环境很友好。准备按这个流程在 Win11 上装一遍 3.12.9,先收藏了。
回复 支持 反对

使用道具 举报

您需要登录后才可以回帖 登录 | 注册

本版积分规则

指导单位

江苏省公安厅

江苏省通信管理局

浙江省台州刑侦支队

DEFCON GROUP 86025

Hacking Group 021A

旗下站点

态势感知中心

应急响应中心

红盟安全

联系我们

官方QQ群:112851260

官方邮箱:security#ihonker.org(#改成@)

官方核心成员

关注微信公众号

Archiver|手机版|小黑屋| ( 沪ICP备2021026908号 )

GMT+8, 2026-11-18 07:46 , Processed in 0.022224 second(s), 18 queries , Gzip On, Redis On.

Powered by ihonker.com

Copyright © 2015-现在.

  • 返回顶部