Win11下Python3.12开发环境搭建与pip配置教程
Win11系统下安装Python 3.12.9,核心不是双击Next,而是勾选Add python.exe to PATH并选择自定义安装路径。下面按安装、验证、pip、首个脚本运行逐段说明。一、版本与安装包选择
Python官方下载页 https://www.python.org/downloads/ 提供免费开源安装包。Win11用户建议安装3.12.x,例如3.12.9,兼顾稳定性和兼容性;需要尝鲜可选择3.13.x。Python 3.12.9不支持Windows 7及更早版本,Win11不受影响。
下载时按系统类型选择:
- 普通64位Windows:Windows installer (64-bit)
- 老旧32位系统:Windows installer (32-bit)
- ARM芯片笔记本:Windows installer (ARM64)
不确定位数时,按Win+I打开设置,进入系统 — 关于查看“系统类型”,显示“64位操作系统”就选64-bit安装包。
二、安装步骤:关键在PATH与安装路径
双击.exe后先不要点Install Now,按下面顺序操作。
1. 最底部两个复选框都要勾选:Use admin privileges when installing py.exe、Add python.exe to PATH。后者不勾选的话,后续cmd中输入python --version会提示“不是内部或外部命令”。
2. 点击Customize installation,而不是Install Now。Install Now会装到当前用户目录下的默认C盘路径,后续维护麻烦。
3. Optional Features保持默认:勾选Documentation、pip、tcl/tk and IDLE、Python test suite、py launcher、for all users (requires admin),然后点Next。
4. Advanced Options中勾选Install for all users、Associate files with Python、Create shortcuts、Add Python to environment variables、Precompile standard library。
5. 修改安装路径。默认路径类似C:\Users\用户名\AppData\Local\Programs\Python\Python312,建议改成D:\Python312或其他非系统盘路径。
6. 点Install安装。安装完成弹出Setup was successful后,务必点击Disable path length limit,解除Windows路径260字符限制,然后点Close。
这里再强调:如果PATH没配置好,后面pip install和python命令都无法在cmd直接使用;环境变量配置错误也是最常见的初学问题。
三、验证安装
按Win+R输入cmd,回车,在命令行执行:
python --version
看到Python 3.12.9即说明解释器已可用。如果提示“不是内部或外部命令”,重新运行安装包,确认Add python.exe to PATH已勾选,或者手动把Python安装目录及Scripts目录加入系统PATH。
四、安装第三方库与pip使用
pip会在安装Python时自动安装。升级pip不是必须步骤,如需要可执行:
python.exe -m pip install --upgrade pip
以安装CAN DBC解析库cantools为例:
pip install cantools
安装成功后会提示Successfully installed cantools-xx.x.x。如果网络原因导致pip下载很慢,可换清华镜像源:
pip install cantools -i https://pypi.tuna.tsinghua.edu.cn/simple
查看环境里已安装的库:
pip list
一个已安装cantools环境的典型输出会包含这些包及版本:
Package Version
----------------- -------
argparse-addons 0.12.0
bitstruct 8.22.1
cantools 41.4.3
crccheck 1.3.1
packaging 26.2
pip 24.3.1
python-can 4.6.1
textparser 0.24.0
typing_extensions 4.15.0
wrapt 1.17.3
这些列表可供核对依赖是否完整,实际版本可能随安装时间变化。
五、运行第一个脚本
先新建文本文件hello.py,内容只写一行:
print("Hello, Python!")
保存后,在cmd中cd到该文件所在目录,再执行:
python hello.py
正常输出:
Hello, Python!
也可以直接用Python自带的IDLE:按Win键搜索IDLE (Python 3.12 64-bit),打开后通过File — New File新建文件,输入上述代码后按F5即可运行。注意IDLE是编辑器/交互环境,不要把命令行窗口和IDLE搞混。
六、常见问题定位
1. python --version报“不是内部或外部命令”:多数是安装时没勾选Add python.exe to PATH,重跑安装包勾选该选项,或在系统环境变量中手动添加Python安装路径。
2. 安装过程中提示需要管理员权限:右键点击安装包,选择“以管理员身份运行”。这通常出现在开启UAC或当前账号权限不足的环境中。
3. pip install下载过慢:换成国内镜像源,清华源地址为https://pypi.tuna.tsinghua.edu.cn/simple,速度会有明显提升。
4. 如果后续要用脚本操作CAN通信并自动解析DBC文件,可以先确认cantools和python-can能正常导入。环境本身配置正确后,这类自动化脚本的开发成本会低很多。
七、小结
到此环境搭建完成:Python 3.12.9已安装,PATH已配置,pip可正常安装第三方库,第一个脚本已能运行。这为后续编写自动解析DBC、生成CAN代码等批量脚本打好了基础。
Re: Win11下Python3.12开发环境搭建与pip配置教程
楼主这篇写得很实用,PATH勾选和自定义安装路径确实是新手最容易踩的两个坑,当初我装Python就直接Next,后来在cmd里敲python提示“不是内部或外部命令”,折腾了半天才搞明白是环境变量的问题。 另外提一点小经验:装完Python如果习惯用VS Code写代码,可以顺手装个Python扩展,直接在编辑器里选解释器就能跑,不过楼主说的命令行基本功还是得先会。cantools和python-can那个示例对搞CAN解析的人来说挺对口,mark一下回头试试。Re: Win11下Python3.12开发环境搭建与pip配置教程
很详细的教程,正好最近在Win11上配Python环境踩了点坑。特别是强调安装时别直接Next、要记得勾PATH这块,对新手来说太关键了。我之前就是忘了勾,后面cmd一直报错,又回去重装了一遍。另外提到Disable path length limit和改非系统盘路径也确实实用,C盘空间紧张的话能省不少心。pip换清华源这段也很实在,默认源下载第三方库有时候确实让人抓狂。有个小疑问:如果之前装过其他Python版本,比如3.9,再装3.12会不会有冲突?需要在PATH里手动调整优先级吗?期待楼主后续出个多版本共存的管理教程。Re: Win11下Python3.12开发环境搭建与pip配置教程
感谢楼主,写得很详细实用!特别是PATH和环境变量那块,确实是新手最容易踩的坑。补充一个小建议:后期装包多的话,可以试试用虚拟环境,把依赖隔离起来,这样不同项目的库版本就不会打架了。不过刚入门的话先按楼主这套流程把环境和pip跑通,是最稳妥的。
页:
[1]