Python入门：Windows平台Python环境配置详解

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.exe

Windows上有两个解释器程序：

• python.exe：运行时会打开一个控制台窗口，适合命令行脚本
• pythonw.exe：运行时没有控制台窗口，适合GUI程序（比如用Tkinter写的桌面应用）

# test_gui.py - 用pythonw.exe运行不会有黑窗口importtkinterastk root=tk.Tk()root.title("我的GUI程序")tk.Label(root,text="Hello from Python!").pack()root.mainloop()

如果你双击运行上述脚本，用pythonw.exe就不会弹出一个黑黢黢的命令行窗口。

2.3 Python Launcher（py.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.12

py.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-c"import 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中应该有两个条目：

1. D:\Python312— 包含python.exe，让你能直接输入python
2. D:\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的配置有三级优先级（后面覆盖前面）：

# 查看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 = columns

4.3 pip缓存管理

pip会把下载的包缓存到本地，以后再安装相同版本的包时就不需要重新下载了：

# 查看缓存目录pip cachedir# 查看缓存占用空间pip cache info# 清理缓存（释放磁盘空间）pip cache purge# 只清理特定包的缓存pip cache remove requests

⚠️ 缓存目录默认在%LOCALAPPDATA%\pip\cache，随着时间推移可能会占用几个G的空间。如果你C盘空间紧张，定期清理一下。

4.4 安装包时的常用选项

# 安装指定版本pipinstallrequests==2.28.0# 安装大于等于某版本pipinstall'requests>=2.28.0'# 安装时不使用缓存（适用于怀疑缓存有问题）pipinstallrequests --no-cache-dir# 安装到用户目录而不是系统目录（不需要管理员权限）pipinstallrequests--user# 从requirements.txt批量安装pipinstall-rrequirements.txt# 生成当前环境的包列表pip freeze>requirements.txt# 升级pip自身python-mpipinstall--upgradepip

五、Windows Terminal：命令行体验升级

5.1 告别老旧的CMD

Windows自带的命令提示符（CMD）功能非常有限：不能多标签页、字体难看、颜色单调、不支持Unicode的一些特殊字符。

✅ Microsoft开发了一款全新的终端工具：Windows Terminal。它支持多标签页、自定义主题、GPU加速渲染、Unicode完美支持。你可以在Microsoft Store中免费下载。

5.2 安装Windows Terminal

① 打开Microsoft Store（Win 10/11自带）
② 搜索"Windows Terminal"
③ 点击"获取"安装

或者使用winget命令行安装：

wingetinstallMicrosoft.WindowsTerminal

5.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 CMD

PowerShell是Windows的新一代命令行解释器，比CMD强大得多。如果你还在用CMD，建议迁移到PowerShell或Windows Terminal中配合使用。

# PowerShell中运行Python脚本python hello.py# 使用管道python-c"print('hello')"|Out-Fileoutput.txt# 查看Python命令的帮助Get-Helppython# PowerShell特有的变量和Python配合$name="小明"python-c"print('Hello$env:name')"# 这样不行python-c"import os; print(f'Hello {os.environ[\"name\"]}')"# 这样也不行# 正确做法：$env:NAME ="小明"python-c"import os; print('Hello ' + os.environ['NAME'])"

6.2 PowerShell执行策略问题

在PowerShell中运行Python虚拟环境的激活脚本时，可能会遇到执行策略错误：

# 错误信息：# 无法加载文件 xxx\Scripts\Activate.ps1，因为在此系统上禁止运行脚本# 查看当前执行策略Get-ExecutionPolicy# 修改为允许本地脚本运行（需要管理员权限的PowerShell）Set-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# 激活虚拟环境（Windows）myproject_env\Scripts\activate# 激活后，命令行前缀会显示环境名(myproject_env)D:\Projects># 此时安装的包都只在当前环境中pipinstallpandas# 退出虚拟环境deactivate

💡 虚拟环境的核心思想：每个项目拥有一套独立的第三方包。项目A用pandas 1.5，项目B用pandas 2.0，互不干扰。

7.4 方案三：使用conda

如果你涉及数据科学、机器学习，conda是一个威力强大的选择：

# 安装Miniconda（轻量版，只有conda+python+pip）# 从 https://docs.conda.io/en/latest/miniconda.html 下载# 创建不同版本的Python环境conda create-npy39python=3.9conda create-npy311python=3.11conda create-npy312python=3.12# 激活环境conda activate py312# 安装包（conda会处理更复杂的依赖关系）condainstallnumpy pandas matplotlib# 查看所有环境condaenvlist# 导出环境配置condaenvexport>environment.yml

conda和pip的核心区别在于：conda不仅管理Python包，还管理非Python的依赖（比如C语言库、系统级工具）。这对科学计算库（numpy、scipy等）尤其重要，因为它们底层依赖大量C/Fortran库。

八、常用IDE和编辑器的选择

8.1 各编辑器简明对比

🔧 后续我们有专门的PyCharm和VS Code详细教程。这里给出结论：

• 如果你是新手，想省心：选PyCharm社区版
• 如果你需要同时写多种语言：选VS Code
• 如果你的电脑配置不高（4GB内存）：选VS Code或Sublime Text
• 如果你做数据科学：选Jupyter Notebook / Jupyter Lab

8.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/11

9.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',encoding='utf-8')asf:f.write('Python中文处理')# 读文件时指定编码withopen('中文文件.txt','r',encoding='utf-8')asf:content=f.read()# 如果遇到GBK编码的文件withopen('老文件.txt','r',encoding='gbk')asf:content=f.read()

💡 从Python 3.7开始，Windows上的Python默认使用UTF-8编码。但为了兼容性，处理中文文件时最好显式指定encoding='utf-8'。

9.4 文件关联问题

双击.py文件时可能出现的情况：

• 直接运行：代码一闪而过（因为是控制台程序，执行完就关了）
• 用编辑器打开：如果你装了PyCharm或VS Code
• 显示"打开方式"对话框：没有正确设置文件关联

修改方法：右键.py文件→"属性"→"打开方式"→选择你想要的程序。

十、Windows上Python开发的最佳实践总结

🔧 一套完整的、精心配置的Windows Python开发环境应该包括：

1. Python 3.11或3.12：从python.org下载安装，务必勾选"Add Python to PATH"
2. pip镜像源配置：%USERPROFILE%\pip\pip.ini中配置清华或阿里镜像
3. py launcher：利用它管理多版本Python
4. Windows Terminal：取代老旧的CMD，享受多标签和美观界面
5. 代码编辑器：PyCharm社区版或VS Code，根据个人偏好选择
6. 每个项目使用虚拟环境：python -m venv env，隔离项目依赖
7. 编码习惯：文件操作时显式指定encoding='utf-8'

✅ 把这七样配置好，你的Windows就完全可以胜任从入门学习到专业开发的Python工作。不要相信"写Python必须用Mac/Linux"的说法——Windows上的Python开发生态已经非常成熟，足够你从零到精通。