Python入门Windows平台Python环境配置详解一、开篇Windows用户的专属配置指南在上一篇文章中我带你完成了Python的初步安装。但光把Python装上去还远远不够——Windows作为Python开发的非原生平台Python诞生于Unix环境有它自己的一套配置逻辑和常见坑点。这篇文章就是Windows用户的专属深度指南。 我会把Windows平台上Python开发的各种配置细节、实用技巧、常见问题一网打尽。读完这篇你就能把Windows打造成一个顺手的Python开发环境。二、重新认识Python在Windows上的安装结构2.1 Python安装目录全解析当你把Python装到D:\Python312或其他自定义路径后来看看这个目录里都有什么D:\Python312\ ├── python.exe ← 这是Python解释器的主程序 ├── pythonw.exe ← 无控制台窗口的Python解释器运行GUI程序用 ├── Lib\ ← Python标准库所有自带的模块都在这里 │ ├── os.py ← os模块的源码 │ ├── json.py ← json模块的源码 │ └── site-packages\ ← 第三方库的安装目录pip安装的包在这里 ├── Scripts\ ← 可执行脚本目录 │ ├── pip.exe ← pip包管理工具 │ ├── pip3.exe │ └── jupyter.exe ← 如果安装了jupyter ├── Doc\ ← Python官方文档如果安装时勾选了 ├── include\ ← C头文件写C扩展时用 ├── libs\ ← C语言静态库 ├── tcl\ ← Tcl/Tk GUI库 └── Tools\ ← 一些实用工具脚本⌨️ 了解这个结构很有用。比如你以后想知道某个第三方库装到哪里了去Lib\site-packages\找就行。2.2 python.exe vs pythonw.exeWindows上有两个解释器程序python.exe运行时会打开一个控制台窗口适合命令行脚本pythonw.exe运行时没有控制台窗口适合GUI程序比如用Tkinter写的桌面应用# test_gui.py - 用pythonw.exe运行不会有黑窗口importtkinterastk roottk.Tk()root.title(我的GUI程序)tk.Label(root,textHello from Python!).pack()root.mainloop()如果你双击运行上述脚本用pythonw.exe就不会弹出一个黑黢黢的命令行窗口。2.3 Python Launcherpy.exe详解这是Windows平台上独有的好东西。在安装Python时如果勾选了py launcher你的系统里会多一个py.exe命令。 py launcher的作用让你在一台电脑上方便地管理和切换多个Python版本。# 查看系统中安装了哪些Python版本py--list# 可能的输出# -3.12-64 *# -3.11-64# -3.9-32# 星号(*)表示当前默认版本# 用指定版本运行脚本py-3.12hello.py# 用Python 3.12运行py-3.11hello.py# 用Python 3.11运行py-3.9hello.py# 用Python 3.9运行# 用默认的Python 3版本运行py-3hello.py# 启动指定版本的交互式环境py-3.12py.exe的工作原理是它安装在C:\Windows\目录下这个目录在PATH中运行时会根据参数去查找已安装的Python版本然后调用对应的python.exe。你可以为每个Python脚本指定它需要的Python版本。在脚本的第一行添加shebang#!python3.12# 这个脚本强制使用Python 3.12运行importsysprint(f当前Python版本:{sys.version})py.exe会读取这个shebang并选择正确的解释器。⚠️ 注意py launcher只在Windows上有。Mac和Linux用的是python3命令或pyenv等工具。三、PATH环境变量深度解析3.1 PATH到底是干什么的这是Windows新手最困惑的概念之一。让我用大白话解释当你在命令行输入python时系统怎么知道去执行D:\Python312\python.exe呢答案就是PATH。 PATH是一个查找路径列表。系统按顺序逐个目录查找你要执行的程序找到了就运行找不到就去下一个目录找所有目录都找不到就报不是内部或外部命令。# 查看当前PATH在cmd中echo%PATH%# 查看当前PATH在PowerShell中$env:PATH-split;# 用Python查看PATHpython-cimport os; [print(p) for p in os.environ[PATH].split(;) if p]PATH中每个目录用分号(;)隔开。一个典型的PATH可能是C:\Windows\system32;C:\Windows;C:\Python312;C:\Python312\Scripts;...3.2 PATH中关于Python的条目一个完整配置的Windows Python环境PATH中应该有两个条目D:\Python312— 包含python.exe让你能直接输入pythonD:\Python312\Scripts— 包含pip.exe、jupyter.exe等脚本工具# 验证PATH配置是否正确where python# 应该显示Python安装路径where pip# 应该显示Scripts路径如果这两个命令都正常显示路径说明PATH配置正确。3.3 手动配置PATH的正确步骤如果你安装时忘了勾选Add Python to PATH或者想修改PATH按以下步骤操作① 按Win R输入sysdm.cpl回车快速打开系统属性② 点击高级选项卡→环境变量按钮③ 环境变量窗口分为上下两部分上面是用户变量只对当前用户生效下面是系统变量对所有用户生效④ 选中用户变量中的Path点击编辑⑤ 点击新建添加两条记录按你自己的安装路径D:\Python312 D:\Python312\Scripts⑥ 用上移按钮把这两条移到靠前的位置系统会按从上到下的顺序查找⑦ 一路点确定关闭所有窗口⚠️ 关键点修改环境变量后之前打开的命令行窗口不会生效。你需要关闭后重新打开命令行或者重启电脑。3.4 PATH优先级导致的问题这是Windows上最经典的Python坑场景你先装了Python 3.11在C:\Python311后来又装了Python 3.12在D:\Python312。现在你在命令行输入python启动的是哪个版本答案是PATH中排在前面的那个目录里的python.exe。# 检查当前python命令实际指向的文件where python 解决方法调小PATH中条目的顺序把你需要用的版本放在前面或者直接用py -3.12来指定版本推荐或者在项目中使用虚拟环境隔离不同版本四、pip在Windows上的深度配置4.1 pip配置文件的位置在第2篇文章中我们简单配置了pip镜像源。这里详细说说Windows上pip的配置文件体系。pip的配置有三级优先级后面覆盖前面级别配置文件位置作用范围global%PROGRAMDATA%\pip\pip.ini系统全局user%USERPROFILE%\pip\pip.ini当前用户site{python安装目录}\Lib\site-packages\pip\pip.conf当前Python实例# 查看pip当前生效的配置pip config list# 查看配置文件的具体位置pip config list-v 推荐使用用户级配置%USERPROFILE%\pip\pip.ini不影响其他用户也不需要管理员权限。4.2 完整的pip.ini配置参考[global] # 镜像源 index-url https://pypi.tuna.tsinghua.edu.cn/simple # 额外的镜像源主源挂了就尝试这些 extra-index-url https://mirrors.aliyun.com/pypi/simple https://pypi.mirrors.ustc.edu.cn/simple # 超时时间秒 timeout 120 # 信任的主机跳过SSL验证 trusted-host pypi.tuna.tsinghua.edu.cn mirrors.aliyun.com pypi.mirrors.ustc.edu.cn [install] # 安装时总是显示进度条 progress-bar on # 不使用缓存调试时开启 # no-cache-dir false [list] # pip list 的输出格式 (legacy, columns, freeze, json) format columns4.3 pip缓存管理pip会把下载的包缓存到本地以后再安装相同版本的包时就不需要重新下载了# 查看缓存目录pip cachedir# 查看缓存占用空间pip cache info# 清理缓存释放磁盘空间pip cache purge# 只清理特定包的缓存pip cache remove requests⚠️ 缓存目录默认在%LOCALAPPDATA%\pip\cache随着时间推移可能会占用几个G的空间。如果你C盘空间紧张定期清理一下。4.4 安装包时的常用选项# 安装指定版本pipinstallrequests2.28.0# 安装大于等于某版本pipinstallrequests2.28.0# 安装时不使用缓存适用于怀疑缓存有问题pipinstallrequests --no-cache-dir# 安装到用户目录而不是系统目录不需要管理员权限pipinstallrequests--user# 从requirements.txt批量安装pipinstall-rrequirements.txt# 生成当前环境的包列表pip freezerequirements.txt# 升级pip自身python-mpipinstall--upgradepip五、Windows Terminal命令行体验升级5.1 告别老旧的CMDWindows自带的命令提示符CMD功能非常有限不能多标签页、字体难看、颜色单调、不支持Unicode的一些特殊字符。✅ Microsoft开发了一款全新的终端工具Windows Terminal。它支持多标签页、自定义主题、GPU加速渲染、Unicode完美支持。你可以在Microsoft Store中免费下载。5.2 安装Windows Terminal① 打开Microsoft StoreWin 10/11自带② 搜索Windows Terminal③ 点击获取安装或者使用winget命令行安装wingetinstallMicrosoft.WindowsTerminal5.3 配置Windows Terminal用于Python开发打开Windows Terminal点击标签栏的“下拉菜单→设置”或按Ctrl ,。推荐配置项外观设置settings.json核心部分{profiles:{defaults:{fontFace:Cascadia Code,// 微软的现代等宽字体支持连字fontSize:12,cursorShape:filledBox,startingDirectory:D:\\Projects\\Python// 默认打开的工作目录},list:[{guid:{...},name:Python Dev,commandline:cmd.exe,startingDirectory:D:\\Projects\\Python,tabTitle:Python,suppressApplicationTitle:true}]}} Windows Terminal支持在同一个窗口里同时打开CMD、PowerShell、Git Bash等多个标签页。写Python时可以一个标签页跑程序另一个标签页操作git效率极高。5.4 让终端运行python更方便在Windows Terminal的设置中你可以添加一个专门的Python配置{guid:{生成一个新的GUID},name:Python 3.12,commandline:D:\\Python312\\python.exe,icon:D:\\Python312\\python.exe,hidden:false}这样在Windows Terminal的菜单中就会多出一个Python 3.12的选项点击直接打开Python交互环境。六、PowerShell中的Python使用技巧6.1 PowerShell vs CMDPowerShell是Windows的新一代命令行解释器比CMD强大得多。如果你还在用CMD建议迁移到PowerShell或Windows Terminal中配合使用。# PowerShell中运行Python脚本python hello.py# 使用管道python-cprint(hello)|Out-Fileoutput.txt# 查看Python命令的帮助Get-Helppython# PowerShell特有的变量和Python配合$name小明python-cprint(Hello$env:name)# 这样不行python-cimport os; print(fHello {os.environ[\name\]})# 这样也不行# 正确做法$env:NAME 小明python-cimport os; print(Hello os.environ[NAME])6.2 PowerShell执行策略问题在PowerShell中运行Python虚拟环境的激活脚本时可能会遇到执行策略错误# 错误信息# 无法加载文件 xxx\Scripts\Activate.ps1因为在此系统上禁止运行脚本# 查看当前执行策略Get-ExecutionPolicy# 修改为允许本地脚本运行需要管理员权限的PowerShellSet-ExecutionPolicy-ExecutionPolicy RemoteSigned-Scope CurrentUser⚠️RemoteSigned策略允许运行本地创建的脚本但下载的脚本需要数字签名。这是安全和使用便利之间的一个平衡选择。6.3 创建PowerShell别名简化操作编辑你的PowerShell配置文件# 查看配置文件路径echo$PROFILE# 如果配置文件不存在创建它New-Item-Path$PROFILE-TypeFile-Force# 编辑配置文件notepad$PROFILE在配置文件中添加Python相关的别名# Python相关别名functionpy{python$args}functionpipi{pip install$args}functionpipu{pip uninstall$args}functionpipl{pip list}functionvenv-new{python-m venv$args[0];Write-Host虚拟环境$args[0] 创建完成}functionvenv-on{.\$args[0]\Scripts\Activate.ps1}functionvenv-off{deactivate}# 快速进入常用的Python项目目录functioncd-py{Set-LocationD:\Projects\Python}保存后重新打开PowerShell你就可以用简短的命令操作了cd-py# 快速进入Python目录venv-new myproject# 创建虚拟环境venv-on myproject# 激活虚拟环境pipi requests# 安装包pipl# 列出已安装的包七、多版本Python共存的完整方案7.1 为什么需要多版本实际工作中你可能会遇到这些场景公司老项目用的是Python 3.9新项目要用Python 3.12测试一个第三方库是否兼容不同Python版本想试用最新版本Python的新特性但保持主力开发版本不变7.2 方案一py launcher最推荐这是Windows上最简单优雅的方案# 查看所有已安装的Pythonpy--list# 创建虚拟环境时指定版本py-3.9-mvenv project_old py-3.11-mvenv project_stable py-3.12-mvenv project_new# 用pip安装包时指定版本py-3.9-mpipinstallpandas py-3.12-mpipinstallpandas# 在脚本shebang中指定版本#!python3.9importsys print(sys.version)7.3 方案二虚拟环境隔离必学无论你用哪个Python版本每个项目都应该有自己的虚拟环境# 创建虚拟环境python-mvenv myproject_env# 激活虚拟环境Windowsmyproject_env\Scripts\activate# 激活后命令行前缀会显示环境名(myproject_env)D:\Projects# 此时安装的包都只在当前环境中pipinstallpandas# 退出虚拟环境deactivate 虚拟环境的核心思想每个项目拥有一套独立的第三方包。项目A用pandas 1.5项目B用pandas 2.0互不干扰。7.4 方案三使用conda如果你涉及数据科学、机器学习conda是一个威力强大的选择# 安装Miniconda轻量版只有condapythonpip# 从 https://docs.conda.io/en/latest/miniconda.html 下载# 创建不同版本的Python环境conda create-npy39python3.9conda create-npy311python3.11conda create-npy312python3.12# 激活环境conda activate py312# 安装包conda会处理更复杂的依赖关系condainstallnumpy pandas matplotlib# 查看所有环境condaenvlist# 导出环境配置condaenvexportenvironment.ymlconda和pip的核心区别在于conda不仅管理Python包还管理非Python的依赖比如C语言库、系统级工具。这对科学计算库numpy、scipy等尤其重要因为它们底层依赖大量C/Fortran库。八、常用IDE和编辑器的选择8.1 各编辑器简明对比工具类型适合人群优缺点IDLE简易IDE纯新手Python自带无需安装但功能太少PyCharm重量级IDE专业开发者功能最全但较吃内存建议8GB以上VS Code轻量级编辑器插件通用开发者轻量灵活插件丰富免费Sublime Text纯编辑器简洁主义启动极快Python支持要自己配Notepad纯编辑器简单编辑超级轻量只适合偶尔看代码 后续我们有专门的PyCharm和VS Code详细教程。这里给出结论如果你是新手想省心选PyCharm社区版如果你需要同时写多种语言选VS Code如果你的电脑配置不高4GB内存选VS Code或Sublime Text如果你做数据科学选Jupyter Notebook / Jupyter Lab8.2 不用IDE也能写Python在配置好PATH的前提下任何文本编辑器都可以写Python# 用记事本写Python最简方法notepad hello.py# 写好代码后命令行运行python hello.py当然没有代码补全和语法高亮写起来会比较辛苦。但理解这一点很重要IDE只是辅助工具真正的写代码运行就靠python.exe就够了。九、Windows特有的常见问题排查9.1 “api-ms-win-crt-runtime-l1-1-0.dll 缺失”这是Windows 7或Windows Server 2008 R2等老系统上常见的问题。原因缺少Visual C Redistributable for Visual Studio 2015运行库。解决方法下载并安装 VC_redist.x64.exe从微软官网或者把系统更新到Windows 10/119.2 Python安装后无法通过https下载包WARNING: Retrying ... SSL: CERTIFICATE_VERIFY_FAILED原因通常是公司网络有代理或者系统根证书过期。解决方法# 临时跳过SSL验证不推荐仅用于紧急情况pipinstallrequests --trusted-host pypi.org --trusted-host files.pythonhosted.org# 永久解决推荐更新根证书# 方法1安装/更新 certifi 包pipinstall--upgradecertifi# 方法2在pip.ini中配置信任主机见第四节9.3 中文编码问题Windows的默认编码是GBK而Python 3默认使用UTF-8。这在处理中文文件时可能出问题# 写文件时指定编码withopen(中文文件.txt,w,encodingutf-8)asf:f.write(Python中文处理)# 读文件时指定编码withopen(中文文件.txt,r,encodingutf-8)asf:contentf.read()# 如果遇到GBK编码的文件withopen(老文件.txt,r,encodinggbk)asf:contentf.read() 从Python 3.7开始Windows上的Python默认使用UTF-8编码。但为了兼容性处理中文文件时最好显式指定encodingutf-8。9.4 文件关联问题双击.py文件时可能出现的情况直接运行代码一闪而过因为是控制台程序执行完就关了用编辑器打开如果你装了PyCharm或VS Code显示打开方式对话框没有正确设置文件关联修改方法右键.py文件→属性→打开方式→选择你想要的程序。十、Windows上Python开发的最佳实践总结 一套完整的、精心配置的Windows Python开发环境应该包括Python 3.11或3.12从python.org下载安装务必勾选Add Python to PATHpip镜像源配置%USERPROFILE%\pip\pip.ini中配置清华或阿里镜像py launcher利用它管理多版本PythonWindows Terminal取代老旧的CMD享受多标签和美观界面代码编辑器PyCharm社区版或VS Code根据个人偏好选择每个项目使用虚拟环境python -m venv env隔离项目依赖编码习惯文件操作时显式指定encodingutf-8✅ 把这七样配置好你的Windows就完全可以胜任从入门学习到专业开发的Python工作。不要相信写Python必须用Mac/Linux的说法——Windows上的Python开发生态已经非常成熟足够你从零到精通。
Python入门：Windows平台Python环境配置详解
发布时间：2026/5/31 23:12:02
Python入门Windows平台Python环境配置详解一、开篇Windows用户的专属配置指南在上一篇文章中我带你完成了Python的初步安装。但光把Python装上去还远远不够——Windows作为Python开发的非原生平台Python诞生于Unix环境有它自己的一套配置逻辑和常见坑点。这篇文章就是Windows用户的专属深度指南。 我会把Windows平台上Python开发的各种配置细节、实用技巧、常见问题一网打尽。读完这篇你就能把Windows打造成一个顺手的Python开发环境。二、重新认识Python在Windows上的安装结构2.1 Python安装目录全解析当你把Python装到D:\Python312或其他自定义路径后来看看这个目录里都有什么D:\Python312\ ├── python.exe ← 这是Python解释器的主程序 ├── pythonw.exe ← 无控制台窗口的Python解释器运行GUI程序用 ├── Lib\ ← Python标准库所有自带的模块都在这里 │ ├── os.py ← os模块的源码 │ ├── json.py ← json模块的源码 │ └── site-packages\ ← 第三方库的安装目录pip安装的包在这里 ├── Scripts\ ← 可执行脚本目录 │ ├── pip.exe ← pip包管理工具 │ ├── pip3.exe │ └── jupyter.exe ← 如果安装了jupyter ├── Doc\ ← Python官方文档如果安装时勾选了 ├── include\ ← C头文件写C扩展时用 ├── libs\ ← C语言静态库 ├── tcl\ ← Tcl/Tk GUI库 └── Tools\ ← 一些实用工具脚本⌨️ 了解这个结构很有用。比如你以后想知道某个第三方库装到哪里了去Lib\site-packages\找就行。2.2 python.exe vs pythonw.exeWindows上有两个解释器程序python.exe运行时会打开一个控制台窗口适合命令行脚本pythonw.exe运行时没有控制台窗口适合GUI程序比如用Tkinter写的桌面应用# test_gui.py - 用pythonw.exe运行不会有黑窗口importtkinterastk roottk.Tk()root.title(我的GUI程序)tk.Label(root,textHello from Python!).pack()root.mainloop()如果你双击运行上述脚本用pythonw.exe就不会弹出一个黑黢黢的命令行窗口。2.3 Python Launcherpy.exe详解这是Windows平台上独有的好东西。在安装Python时如果勾选了py launcher你的系统里会多一个py.exe命令。 py launcher的作用让你在一台电脑上方便地管理和切换多个Python版本。# 查看系统中安装了哪些Python版本py--list# 可能的输出# -3.12-64 *# -3.11-64# -3.9-32# 星号(*)表示当前默认版本# 用指定版本运行脚本py-3.12hello.py# 用Python 3.12运行py-3.11hello.py# 用Python 3.11运行py-3.9hello.py# 用Python 3.9运行# 用默认的Python 3版本运行py-3hello.py# 启动指定版本的交互式环境py-3.12py.exe的工作原理是它安装在C:\Windows\目录下这个目录在PATH中运行时会根据参数去查找已安装的Python版本然后调用对应的python.exe。你可以为每个Python脚本指定它需要的Python版本。在脚本的第一行添加shebang#!python3.12# 这个脚本强制使用Python 3.12运行importsysprint(f当前Python版本:{sys.version})py.exe会读取这个shebang并选择正确的解释器。⚠️ 注意py launcher只在Windows上有。Mac和Linux用的是python3命令或pyenv等工具。三、PATH环境变量深度解析3.1 PATH到底是干什么的这是Windows新手最困惑的概念之一。让我用大白话解释当你在命令行输入python时系统怎么知道去执行D:\Python312\python.exe呢答案就是PATH。 PATH是一个查找路径列表。系统按顺序逐个目录查找你要执行的程序找到了就运行找不到就去下一个目录找所有目录都找不到就报不是内部或外部命令。# 查看当前PATH在cmd中echo%PATH%# 查看当前PATH在PowerShell中$env:PATH-split;# 用Python查看PATHpython-cimport os; [print(p) for p in os.environ[PATH].split(;) if p]PATH中每个目录用分号(;)隔开。一个典型的PATH可能是C:\Windows\system32;C:\Windows;C:\Python312;C:\Python312\Scripts;...3.2 PATH中关于Python的条目一个完整配置的Windows Python环境PATH中应该有两个条目D:\Python312— 包含python.exe让你能直接输入pythonD:\Python312\Scripts— 包含pip.exe、jupyter.exe等脚本工具# 验证PATH配置是否正确where python# 应该显示Python安装路径where pip# 应该显示Scripts路径如果这两个命令都正常显示路径说明PATH配置正确。3.3 手动配置PATH的正确步骤如果你安装时忘了勾选Add Python to PATH或者想修改PATH按以下步骤操作① 按Win R输入sysdm.cpl回车快速打开系统属性② 点击高级选项卡→环境变量按钮③ 环境变量窗口分为上下两部分上面是用户变量只对当前用户生效下面是系统变量对所有用户生效④ 选中用户变量中的Path点击编辑⑤ 点击新建添加两条记录按你自己的安装路径D:\Python312 D:\Python312\Scripts⑥ 用上移按钮把这两条移到靠前的位置系统会按从上到下的顺序查找⑦ 一路点确定关闭所有窗口⚠️ 关键点修改环境变量后之前打开的命令行窗口不会生效。你需要关闭后重新打开命令行或者重启电脑。3.4 PATH优先级导致的问题这是Windows上最经典的Python坑场景你先装了Python 3.11在C:\Python311后来又装了Python 3.12在D:\Python312。现在你在命令行输入python启动的是哪个版本答案是PATH中排在前面的那个目录里的python.exe。# 检查当前python命令实际指向的文件where python 解决方法调小PATH中条目的顺序把你需要用的版本放在前面或者直接用py -3.12来指定版本推荐或者在项目中使用虚拟环境隔离不同版本四、pip在Windows上的深度配置4.1 pip配置文件的位置在第2篇文章中我们简单配置了pip镜像源。这里详细说说Windows上pip的配置文件体系。pip的配置有三级优先级后面覆盖前面级别配置文件位置作用范围global%PROGRAMDATA%\pip\pip.ini系统全局user%USERPROFILE%\pip\pip.ini当前用户site{python安装目录}\Lib\site-packages\pip\pip.conf当前Python实例# 查看pip当前生效的配置pip config list# 查看配置文件的具体位置pip config list-v 推荐使用用户级配置%USERPROFILE%\pip\pip.ini不影响其他用户也不需要管理员权限。4.2 完整的pip.ini配置参考[global] # 镜像源 index-url https://pypi.tuna.tsinghua.edu.cn/simple # 额外的镜像源主源挂了就尝试这些 extra-index-url https://mirrors.aliyun.com/pypi/simple https://pypi.mirrors.ustc.edu.cn/simple # 超时时间秒 timeout 120 # 信任的主机跳过SSL验证 trusted-host pypi.tuna.tsinghua.edu.cn mirrors.aliyun.com pypi.mirrors.ustc.edu.cn [install] # 安装时总是显示进度条 progress-bar on # 不使用缓存调试时开启 # no-cache-dir false [list] # pip list 的输出格式 (legacy, columns, freeze, json) format columns4.3 pip缓存管理pip会把下载的包缓存到本地以后再安装相同版本的包时就不需要重新下载了# 查看缓存目录pip cachedir# 查看缓存占用空间pip cache info# 清理缓存释放磁盘空间pip cache purge# 只清理特定包的缓存pip cache remove requests⚠️ 缓存目录默认在%LOCALAPPDATA%\pip\cache随着时间推移可能会占用几个G的空间。如果你C盘空间紧张定期清理一下。4.4 安装包时的常用选项# 安装指定版本pipinstallrequests2.28.0# 安装大于等于某版本pipinstallrequests2.28.0# 安装时不使用缓存适用于怀疑缓存有问题pipinstallrequests --no-cache-dir# 安装到用户目录而不是系统目录不需要管理员权限pipinstallrequests--user# 从requirements.txt批量安装pipinstall-rrequirements.txt# 生成当前环境的包列表pip freezerequirements.txt# 升级pip自身python-mpipinstall--upgradepip五、Windows Terminal命令行体验升级5.1 告别老旧的CMDWindows自带的命令提示符CMD功能非常有限不能多标签页、字体难看、颜色单调、不支持Unicode的一些特殊字符。✅ Microsoft开发了一款全新的终端工具Windows Terminal。它支持多标签页、自定义主题、GPU加速渲染、Unicode完美支持。你可以在Microsoft Store中免费下载。5.2 安装Windows Terminal① 打开Microsoft StoreWin 10/11自带② 搜索Windows Terminal③ 点击获取安装或者使用winget命令行安装wingetinstallMicrosoft.WindowsTerminal5.3 配置Windows Terminal用于Python开发打开Windows Terminal点击标签栏的“下拉菜单→设置”或按Ctrl ,。推荐配置项外观设置settings.json核心部分{profiles:{defaults:{fontFace:Cascadia Code,// 微软的现代等宽字体支持连字fontSize:12,cursorShape:filledBox,startingDirectory:D:\\Projects\\Python// 默认打开的工作目录},list:[{guid:{...},name:Python Dev,commandline:cmd.exe,startingDirectory:D:\\Projects\\Python,tabTitle:Python,suppressApplicationTitle:true}]}} Windows Terminal支持在同一个窗口里同时打开CMD、PowerShell、Git Bash等多个标签页。写Python时可以一个标签页跑程序另一个标签页操作git效率极高。5.4 让终端运行python更方便在Windows Terminal的设置中你可以添加一个专门的Python配置{guid:{生成一个新的GUID},name:Python 3.12,commandline:D:\\Python312\\python.exe,icon:D:\\Python312\\python.exe,hidden:false}这样在Windows Terminal的菜单中就会多出一个Python 3.12的选项点击直接打开Python交互环境。六、PowerShell中的Python使用技巧6.1 PowerShell vs CMDPowerShell是Windows的新一代命令行解释器比CMD强大得多。如果你还在用CMD建议迁移到PowerShell或Windows Terminal中配合使用。# PowerShell中运行Python脚本python hello.py# 使用管道python-cprint(hello)|Out-Fileoutput.txt# 查看Python命令的帮助Get-Helppython# PowerShell特有的变量和Python配合$name小明python-cprint(Hello$env:name)# 这样不行python-cimport os; print(fHello {os.environ[\name\]})# 这样也不行# 正确做法$env:NAME 小明python-cimport os; print(Hello os.environ[NAME])6.2 PowerShell执行策略问题在PowerShell中运行Python虚拟环境的激活脚本时可能会遇到执行策略错误# 错误信息# 无法加载文件 xxx\Scripts\Activate.ps1因为在此系统上禁止运行脚本# 查看当前执行策略Get-ExecutionPolicy# 修改为允许本地脚本运行需要管理员权限的PowerShellSet-ExecutionPolicy-ExecutionPolicy RemoteSigned-Scope CurrentUser⚠️RemoteSigned策略允许运行本地创建的脚本但下载的脚本需要数字签名。这是安全和使用便利之间的一个平衡选择。6.3 创建PowerShell别名简化操作编辑你的PowerShell配置文件# 查看配置文件路径echo$PROFILE# 如果配置文件不存在创建它New-Item-Path$PROFILE-TypeFile-Force# 编辑配置文件notepad$PROFILE在配置文件中添加Python相关的别名# Python相关别名functionpy{python$args}functionpipi{pip install$args}functionpipu{pip uninstall$args}functionpipl{pip list}functionvenv-new{python-m venv$args[0];Write-Host虚拟环境$args[0] 创建完成}functionvenv-on{.\$args[0]\Scripts\Activate.ps1}functionvenv-off{deactivate}# 快速进入常用的Python项目目录functioncd-py{Set-LocationD:\Projects\Python}保存后重新打开PowerShell你就可以用简短的命令操作了cd-py# 快速进入Python目录venv-new myproject# 创建虚拟环境venv-on myproject# 激活虚拟环境pipi requests# 安装包pipl# 列出已安装的包七、多版本Python共存的完整方案7.1 为什么需要多版本实际工作中你可能会遇到这些场景公司老项目用的是Python 3.9新项目要用Python 3.12测试一个第三方库是否兼容不同Python版本想试用最新版本Python的新特性但保持主力开发版本不变7.2 方案一py launcher最推荐这是Windows上最简单优雅的方案# 查看所有已安装的Pythonpy--list# 创建虚拟环境时指定版本py-3.9-mvenv project_old py-3.11-mvenv project_stable py-3.12-mvenv project_new# 用pip安装包时指定版本py-3.9-mpipinstallpandas py-3.12-mpipinstallpandas# 在脚本shebang中指定版本#!python3.9importsys print(sys.version)7.3 方案二虚拟环境隔离必学无论你用哪个Python版本每个项目都应该有自己的虚拟环境# 创建虚拟环境python-mvenv myproject_env# 激活虚拟环境Windowsmyproject_env\Scripts\activate# 激活后命令行前缀会显示环境名(myproject_env)D:\Projects# 此时安装的包都只在当前环境中pipinstallpandas# 退出虚拟环境deactivate 虚拟环境的核心思想每个项目拥有一套独立的第三方包。项目A用pandas 1.5项目B用pandas 2.0互不干扰。7.4 方案三使用conda如果你涉及数据科学、机器学习conda是一个威力强大的选择# 安装Miniconda轻量版只有condapythonpip# 从 https://docs.conda.io/en/latest/miniconda.html 下载# 创建不同版本的Python环境conda create-npy39python3.9conda create-npy311python3.11conda create-npy312python3.12# 激活环境conda activate py312# 安装包conda会处理更复杂的依赖关系condainstallnumpy pandas matplotlib# 查看所有环境condaenvlist# 导出环境配置condaenvexportenvironment.ymlconda和pip的核心区别在于conda不仅管理Python包还管理非Python的依赖比如C语言库、系统级工具。这对科学计算库numpy、scipy等尤其重要因为它们底层依赖大量C/Fortran库。八、常用IDE和编辑器的选择8.1 各编辑器简明对比工具类型适合人群优缺点IDLE简易IDE纯新手Python自带无需安装但功能太少PyCharm重量级IDE专业开发者功能最全但较吃内存建议8GB以上VS Code轻量级编辑器插件通用开发者轻量灵活插件丰富免费Sublime Text纯编辑器简洁主义启动极快Python支持要自己配Notepad纯编辑器简单编辑超级轻量只适合偶尔看代码 后续我们有专门的PyCharm和VS Code详细教程。这里给出结论如果你是新手想省心选PyCharm社区版如果你需要同时写多种语言选VS Code如果你的电脑配置不高4GB内存选VS Code或Sublime Text如果你做数据科学选Jupyter Notebook / Jupyter Lab8.2 不用IDE也能写Python在配置好PATH的前提下任何文本编辑器都可以写Python# 用记事本写Python最简方法notepad hello.py# 写好代码后命令行运行python hello.py当然没有代码补全和语法高亮写起来会比较辛苦。但理解这一点很重要IDE只是辅助工具真正的写代码运行就靠python.exe就够了。九、Windows特有的常见问题排查9.1 “api-ms-win-crt-runtime-l1-1-0.dll 缺失”这是Windows 7或Windows Server 2008 R2等老系统上常见的问题。原因缺少Visual C Redistributable for Visual Studio 2015运行库。解决方法下载并安装 VC_redist.x64.exe从微软官网或者把系统更新到Windows 10/119.2 Python安装后无法通过https下载包WARNING: Retrying ... SSL: CERTIFICATE_VERIFY_FAILED原因通常是公司网络有代理或者系统根证书过期。解决方法# 临时跳过SSL验证不推荐仅用于紧急情况pipinstallrequests --trusted-host pypi.org --trusted-host files.pythonhosted.org# 永久解决推荐更新根证书# 方法1安装/更新 certifi 包pipinstall--upgradecertifi# 方法2在pip.ini中配置信任主机见第四节9.3 中文编码问题Windows的默认编码是GBK而Python 3默认使用UTF-8。这在处理中文文件时可能出问题# 写文件时指定编码withopen(中文文件.txt,w,encodingutf-8)asf:f.write(Python中文处理)# 读文件时指定编码withopen(中文文件.txt,r,encodingutf-8)asf:contentf.read()# 如果遇到GBK编码的文件withopen(老文件.txt,r,encodinggbk)asf:contentf.read() 从Python 3.7开始Windows上的Python默认使用UTF-8编码。但为了兼容性处理中文文件时最好显式指定encodingutf-8。9.4 文件关联问题双击.py文件时可能出现的情况直接运行代码一闪而过因为是控制台程序执行完就关了用编辑器打开如果你装了PyCharm或VS Code显示打开方式对话框没有正确设置文件关联修改方法右键.py文件→属性→打开方式→选择你想要的程序。十、Windows上Python开发的最佳实践总结 一套完整的、精心配置的Windows Python开发环境应该包括Python 3.11或3.12从python.org下载安装务必勾选Add Python to PATHpip镜像源配置%USERPROFILE%\pip\pip.ini中配置清华或阿里镜像py launcher利用它管理多版本PythonWindows Terminal取代老旧的CMD享受多标签和美观界面代码编辑器PyCharm社区版或VS Code根据个人偏好选择每个项目使用虚拟环境python -m venv env隔离项目依赖编码习惯文件操作时显式指定encodingutf-8✅ 把这七样配置好你的Windows就完全可以胜任从入门学习到专业开发的Python工作。不要相信写Python必须用Mac/Linux的说法——Windows上的Python开发生态已经非常成熟足够你从零到精通。
相关文章
为什么90%的Gemini部署失败？2024最新版SDK兼容性断层、模型漂移补偿、API限流熔断三重避坑手册
更多请点击： https://intelliparadigm.com 第一章：Gemini舆情预警系统 Gemini舆情预警系统是基于Google Gemini大模型构建的实时多源舆情感知与风险识别平台，深度融合自然语言理解、事件抽取与情感强度建模能力，面向政企客户实现…
缠论可视化插件：3分钟让复杂K线结构一目了然的智能分析工具终极指南
缠论可视化插件：3分钟让复杂K线结构一目了然的智能分析工具终极指南 【免费下载链接】Indicator 通达信缠论可视化分析插件 项目地址: https://gitcode.com/gh_mirrors/ind/Indicator 还在为复杂的缠论分析感到困惑吗？面对K线图上密密麻麻的顶底分…
27-企业安全实践
本节目标完成本节学习后，你将能够：配置 .claude/settings.json 安全规则，精准控制 Claude Code 的权限边界识别并分类危险命令，实施分级阻止策略（警告/确认/禁止）使用 /sandbox 命令实现 OS 级进程隔离&…
Topit：如何用3步操作让你的macOS窗口永远保持在最前面？
Topit：如何用3步操作让你的macOS窗口永远保持在最前面？ 【免费下载链接】Topit Pin any window to the top of your screen / 在Mac上将你的任何窗口强制置顶 项目地址: https://gitcode.com/gh_mirrors/to/Topit 你是否曾经在同时处理多个任务时…
重塑 Java 世界的两根支柱：穿透 Spring IoC 与 AOP 的架构哲学
在 Java 漫长的发展史中，如果没有 Spring 框架的诞生，企业级开发可能至今仍在一片泥潭中挣扎。而撑起 Spring 这个庞大帝国的，正是其最底层的两大核心基石：IoC（控制反转） 与 AOP（面向切面编程&a…
从繁琐到极简，从幻象到本质：Spring AOP 架构演进与实战避坑指南
在 Spring 框架的宏大版图中，如果说 IoC（控制反转）是用来管理对象的“容器”，那么 AOP（面向切面编程）就是用来给这些对象“穿上顶级装备的附魔台”。无论是声明式事务（Transactional）…
可组合Harness：通过中间件链增强Agent能力
可组合Harness：通过中间件链增强Agent能力 一、 引言 (Introduction) 1.1 钩子 (The Hook) “你是否试过部署了一个大模型Agent应用，却发现它要么只会干巴巴地按Prompt干活——要么重复相同的错误，要么完全不懂怎么利用私有知识库，要么不知道什么时候该调用外部工具？更气…
洛雪音乐音源完全指南：5分钟解锁全网无损音乐资源
洛雪音乐音源完全指南：5分钟解锁全网无损音乐资源 【免费下载链接】lxmusic- lxmusic(洛雪音乐)全网最新最全音源 项目地址: https://gitcode.com/gh_mirrors/lx/lxmusic- 你是否曾经为了听一首歌，需要在多个音乐APP之间来回切换？是否…
告别License焦虑：一套脚本自动监控你的Tasking for TriCore v6.3r1许可是否健康
告别License焦虑：一套脚本自动监控你的Tasking for TriCore v6.3r1许可是否健康在Aurix项目开发中，Tasking TriCore编译器是嵌入式工程师的核心工具之一。但许多团队都遇到过这样的尴尬时刻：编译任务突然中断，控制台弹出冰冷的&qu…
Win10/Win11下Realtek 8188GU网卡驱动感叹号？别急着扔，试试这个手动安装的野路子
Realtek 8188GU网卡驱动故障深度修复指南：从原理到实战当设备管理器里那个顽固的黄色感叹号挥之不去，而你已经尝试了所有"标准操作"——Windows自动更新、第三方驱动工具、甚至重启大法——却依然无济于事时，是时候换个思路了。这篇…
AnolisOS 8.8安装源配置踩坑实录：从‘设置基础软件仓库时出错’到成功联网的保姆级指南
AnolisOS 8.8安装源配置实战指南：从诊断到解决方案的全流程解析当你在安装AnolisOS 8.8时遇到"设置基础软件仓库时出错"的提示，这通常意味着系统无法访问或识别安装源。这个问题看似简单，但背后可能涉及网络配置、镜像选择、启动参…
基于树莓派Pico的反应速度测试游戏：从GPIO编程到状态机实战
1. 项目概述与核心思路最近在整理工作室的电子元件，翻出来几个闲置的街机按钮和一块树莓派Pico，灵机一动，决定做个简单又有趣的反应速度测试游戏。这个项目非常适合想入门嵌入式开发的朋友，它不涉及复杂的传感器和通信协议&#x…
Win10/Win11下Realtek 8188GU网卡驱动感叹号？别急着扔，试试这个手动安装的野路子
Realtek 8188GU网卡驱动故障深度修复指南：从原理到实战当设备管理器里那个顽固的黄色感叹号挥之不去，而你已经尝试了所有"标准操作"——Windows自动更新、第三方驱动工具、甚至重启大法——却依然无济于事时，是时候换个思路了。这篇…
AnolisOS 8.8安装源配置踩坑实录：从‘设置基础软件仓库时出错’到成功联网的保姆级指南
AnolisOS 8.8安装源配置实战指南：从诊断到解决方案的全流程解析当你在安装AnolisOS 8.8时遇到"设置基础软件仓库时出错"的提示，这通常意味着系统无法访问或识别安装源。这个问题看似简单，但背后可能涉及网络配置、镜像选择、启动参…
基于树莓派Pico的反应速度测试游戏：从GPIO编程到状态机实战
1. 项目概述与核心思路最近在整理工作室的电子元件，翻出来几个闲置的街机按钮和一块树莓派Pico，灵机一动，决定做个简单又有趣的反应速度测试游戏。这个项目非常适合想入门嵌入式开发的朋友，它不涉及复杂的传感器和通信协议&#x…
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案 【免费下载链接】MPC-BE MPC-BE – универсальный проигрыватель аудио и видеофайлов для операционной системы Windows. 项目地址:…
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南 【免费下载链接】STL-Volume-Model-Calculator STL Volume Model Calculator Python 项目地址: https://gitcode.com/gh_mirrors/st/STL-Volume-Model-Calculator 你是否曾经为3D打印项目…
通过Taotoken CLI工具一键配置团队开发环境与模型密钥
通过Taotoken CLI工具一键配置团队开发环境与模型密钥 1. CLI工具安装与基本使用 Taotoken提供的CLI工具可通过npm全局安装或直接使用npx运行。对于需要频繁使用CLI的团队，推荐全局安装： npm install -g taotoken/taotoken对于临时使用或项目级配置&a…