简介面向 Python 零基础初学者的环境搭建图文指南重点解决 Python 解释器安装与 PyCharm 集成开发环境配置两大难题帮助读者从零开始构建可用的 Python 开发环境。资源包含 1 个 docx 格式的 Word 文档压缩包大小约 1.14 兆字节文件虽少但内容完整适合离线保存或打印后对照操作。文档以步骤截图和文字说明相结合详细覆盖了从 Python 官网下载、安装选项勾选、命令行验证安装结果到 PyCharm 官网下载、安装路径选择、首次运行设置、新建项目和创建第一个 Python 文件的完整流程。同时特别标注了安装过程中需要勾选的关键选项以及常见错误提示对应的排错思路能有效减少初学者在环境配置阶段踩坑。当前已有 1120 人学习下载无论是刚接触编程的学生还是希望快速搭建开发环境的职场新人都可以把这份文档作为入门操作手册。1. 环境没搭好后面全是坑这份 Python 与 PyCharm 安装笔记怎么用很多刚入门的开发者在拿到 Python 资源包之后第一步不是写 hello world而是卡在环境安装上——要么双击安装包一闪而过要么装完在命令行敲 python 弹出“不是内部或外部命令”折腾一晚上连解释器都没跑起来。这篇笔记把 Python 安装拆成四件事选版下载、PATH 勾选、命令行验证、PyCharm 关联解释器每一步都标注了对应的参数含义和常见翻车点。适合第一台电脑装 Python 的纯新手也适合帮同学同事装环境装到想放弃的“工具人”。照着走一遍十分钟内能看到稳定运行的 Python 和 PyCharm。2. Python 本体安装下载选版、PATH 勾选与安装后的三种验证2.1 下载前先做好两个决定版本与位数很多人打开官网下载页后直接点最大的黄色按钮实际上下载页里同时存在多个版本入口。当前官网默认展示的是最新稳定版但页面下方还会列出旧版本入口和预览版入口。我的建议是新手无条件选最新稳定版不要碰预览版。预览版通常标注了 “Pre-release” 或 “Beta”这类版本可能存在第三方库尚未适配的兼容问题装完很容易在后续装 pandas、numpy 时报编译错误。位数选择也是提前要做的事。Windows 下分为 64 位和 32 位两种安装包判断方法很简单右键“此电脑”选“属性”查看“系统类型”一栏。现在市面上的电脑绝大多数是 64 位系统直接下载 64 位包。有一点要提醒如果电脑是 64 位系统千万不要为了“省空间”装 32 位 Python后续装某些科学计算库会直接因为缺少 VC 运行库而失败纯属给自己挖坑。还有一个常见误用同一台电脑装了两个版本比如 3.9 和 3.12结果命令行敲 python 时命中的不是自己以为的那个版本。这里不做太复杂的多版本管理方案新手阶段做到一点就够了——只装一个版本。装完想确认当前默认版本的命令我会在 2.3 节讲。下载的安装包来源也要强调一下只认官网下载页不要用网盘里流传的“绿色版”“精简版”。这类版本往往阉割了 pip、venv 等关键组件装完后面装第三方库时会发现 pip 命令不存在那时候再补装比重新安装还费劲。2.2 安装向导里最不该跳过的那一步Add to PATH双击下载好的 exe 文件后安装向导第一屏底部有一个复选框写着 “Add python.exe to PATH”。这是整个安装过程中最关键的选项没有之一。PATH 是 Windows 的系统环境变量作用类似于一个全局索引。你把 Python 的安装目录加进 PATHcmd 里敲 python 才能直接找到解释器。如果没勾选Python 本身是装上了但你没法在命令行直接调用后续 PyCharm 里配置解释器也会更麻烦。这一屏有两个入口“Install Now” 和 “Customize installation”。我的习惯是选 “Customize installation”虽然多两步点击但能把安装路径和关键选项掌控住。进入后先看到的是一组可选组件默认全部勾选就行其中 pip 这一项必须保留它是后面装第三方库的通道。真正需要区分的是下一步界面里的 “Add Python to PATH”这个选项默认是关闭的必须手动打开。路径设置这里有一个非常典型的踩坑点安装路径不要带中文不要带空格。比如把 Python 装到D:\Python311没有问题但装到D:\软件\Python 311就可能在后续某个工具里出现莫名其妙的路径解析错误。这类问题属于典型的“玄学报错”报错信息往往不直接指向路径排查起来非常浪费时间。我一般会提醒身边的人在安装阶段多留一个心眼后面能省一晚上的排查时间。2.3 装完别急着关命令行三连验证安装进度条走完先别急着打开 PyCharm。按Win R输入cmd回车在弹出的命令行窗口里依次跑下面的命令确认解释器真正生效。python --version--version参数表示输出当前 Python 的版本号。这里要说明一下python --version和python -V效果一样但--version写法更通用在脚本里也不容易和别的参数混淆。安装成功的话屏幕上会输出类似Python 3.12.1的信息。如果提示“不是内部或外部命令”说明 PATH 那一步没生效直接回看 2.2 节。where pythonwhere是 Windows 自带的文件查找命令作用是遍历 PATH 里的所有目录找出python.exe的实际位置。正常会输出一两条路径第一条就是命令行实际调用的那个解释器。这一步的意义在于确认你跑的命令到底用的是哪一份 Python尤其是以后装多版本时这个命令能帮你快速定位冲突。python不加任何参数直接执行python会进入 Python 的交互式解释器REPL屏幕显示版本信息和提示符。到这里exit()回车退出即可。这一步验证的是安装包的功能完整性有些安装包虽然能显示版本号但进入交互模式后闪退说明解释器本身有损坏需要重新安装。三连验证全部通过后Python 本体才算真正装好了。需要注意的是如果你在安装完成后才打开新的命令行窗口上面的命令才能生效因为 PATH 是在打开窗口那一刻被读取的。2.4 多个 Python 并存时怎么查默认解释器如果电脑上原本就有另一个 Python或者系统里预装了 Microsoft Store 版 Python命令行命中的可能是旧版。遇到这种情况优先用命令确认当前生效的解释器路径而不是盲敲python --version。py --listpy是 Windows 自带的 Python launcher它专门管理同一台电脑上的多版本 Python。--list参数会列出所有已注册的 Python 版本每行前面带*的是默认版本。这个命令比where python更可靠因为它看的是版本注册表而不是 PATH 里的文件顺序。如果发现默认版本不对常见做法是卸载旧版本或者手动调整系统环境变量 Path 里的顺序。新手阶段不建议深入折腾先保证只有一个 Python 在 PATH 里即可。3. PyCharm 装配社区版与专业版选型、首次启动与解释器关联3.1 下载前先想清楚Community 版还是 Professional 版PyCharm 的下载页在官网上提供两个版本Community社区版和 Professional专业版。很多教程默认让新手下载专业版但专业版是付费的并且它多出来的主要功能——远程调试、数据库工具、Docker 集成——在入门阶段大概率一个都用不上。社区版和专业版的差异可以用一张表说清楚对比项Community 版Professional 版费用免费开源按年订阅Python 项目创建与运行支持支持代码补全与调试支持支持Git 集成支持支持远程解释器SSH不支持支持数据库客户端不支持支持Web 开发框架支持部分完整我的建议是最新安装 Community 版学到 Web 框架开发阶段再考虑升级也完全来得及。另外要提醒一句不要为了用专业版去搜各种“激活方案”一方面有安全风险另一方面社区版对入门阶段已经足够。把这个时间省下来多写几行代码更划算。3.2 安装选项里哪些勾选是给自己留的后悔药PyCharm 的安装向导过程中有一个页面会列出需要勾选的可选组件。新手容易一路 Next 直接带过但里面有两个选项建议勾上第一个是 “Create Desktop Shortcut”道理很简单后面每天都会打开放在桌面上最顺手。第二个是 “Add launchers dir to the PATH”。勾选这个选项后命令行里可以直接输入pycharm打开 IDE。这个功能不一定每天用到但在某些场景下非常方便比如你需要在命令行打开某个项目时直接一条命令加空格加项目路径并回车比如pycharm ./my_project。安装路径这里还是那句话默认路径在 C 盘没有关系但如果 C 盘空间紧张建议安装前就把路径改到 D 盘比如D:\PyCharm。PyCharm 之后会占用的空间不小随着插件和缓存积累还可能进一步膨胀早点换盘后面省心。安装最后一步弹出的 “Finish” 按钮前如果勾了 “Run PyCharm”它会直接启动 IDE。我一般会取消这个勾选因为首次启动还需要配置不如先把项目目录想好再打开。3.3 首次启动配置主题、配置文件导入与许可协议第一次双击 PyCharm 图标会先弹出主题选择界面Darcula深色和 IntelliJ Light浅色。这个选择完全看个人偏好之后也可以在设置里随时切换不影响任何功能。接着会询问是否导入之前的配置目录。如果是全新安装直接选 “Do not import settings”选错选项反而可能把旧版本里的配置文件带过来出现编辑器字体和快捷键异常这种不好排查的问题。后续界面会要求登录 JetBrains 账号。这里特别提醒不登录账号也可以正常使用社区版。遇到登录页面直接选择 Skip 或 Continue 即可登录账号不是必须项千万不要卡在这一步。3.4 新建项目时 Interpreter 别选错首次进入 IDE 后会看到 “New Project” 按钮点击进入项目配置页。这个页面有两个核心字段Location 和 Interpreter。Location 是项目存放目录里面填的路径会直接生成一个以该名字命名的文件夹建议把路径放在好找的位置比如D:\PythonProjects\demo。这里不要放在系统盘用户目录深处不然以后想用命令行进入项目时路径太长容易打错。Interpreter 是 Python 解释器这一项选择决定了代码运行在哪一个 Python 版本上。新手最容易翻车的地方就在这里下拉框里显示了一堆选项但默认选的可能是一个全新的虚拟环境路径代码跑起来时用的并不是你刚安装的 Python。我建议入门阶段直接使用已安装的 Python不要创建虚拟环境先把解释器关联这一步走通再说提示在 Interpreter 下拉框中选择 “Existing interpreter”然后点击右侧的 “...” 浏览按钮定位到刚安装的 python.exe 文件所在目录。目录一般形如D:\Python311\python.exe选中即完成关联。这一步做对后项目创建界面会显示具体版本号比如 “Python 3.12”说明 PyCharm 已经正确识别了解释器。如果下拉框里找不到 python.exe大概率是 2.2 节的 PATH 没配好回到第 2 章重新检查。4. 跑通第一个程序项目创建、代码编写与 pip 依赖配置4.1 在 PyCharm 里创建 Python 文件并运行项目创建完成后进入主界面。在左侧的项目树中鼠标右键点击项目根目录依次选择New - Python File在弹出的对话框中输入文件名比如first。注意这里不需要加.py后缀PyCharm 会自动补上。文件创建成功后右侧编辑区打开一个空文件输入下面两行代码print(Hello, Python) print(环境配置成功可以开始写代码了)print是 Python 的内置函数作用是向控制台输出括号里的内容。字符串必须用引号包起来单引号和双引号都可以但同一个字符串内不能混用。输入完成后在编辑器区域内右键选择Run first。此时 PyCharm 会把文件交给刚才关联的解释器去执行底部弹出 Run 窗口并显示两行输出内容。如果能看到这两行输出说明 Python、PyCharm、解释器三者已经完全打通。4.2 运行按钮背后的执行链路这里有必要讲一下点击 Run 之后发生了什么因为不少新手把“运行”当成黑匣子出了问题不知道怎么排查。PyCharm 执行 Python 文件时实际做的事情是先定位当前项目的 interpreter 配置然后在后台拼出一条完整的命令这条命名的内容相当于在命令行执行python D:/PythonProjects/demo/first.py。解释器读取这个.py文件逐行编译成字节码再由 Python 虚拟机执行。Run 窗口里显示的内容就是程序的标准输出。明白这条链路后排查问题就变得有方向了。比如运行后提示No such file or directory问题大概率出在路径上而不是代码本身。再比如运行后弹出版本不对的报错先回去看 interpreter 有没有关联错。Run 按钮旁边还有一个 Debug 按钮两者的区别在于 Debug 会启动调试器运行到打了断点的行时暂停。入门阶段先用 Run 跑通即可Debug 的断点功能等写复杂业务逻辑时再学。4.3 依赖装不上先配好 pip 镜像源第一个程序跑通之后很快会遇到一个新需求安装第三方库。安装命令是pip install 包名但默认的软件源在国外国内网络环境下经常出现下载到一半超时、重试多次后报错的现象。这不是 pip 本身坏了而是网络链路问题。临时解决方案是在安装命令后面加一个-i参数把下载源指向镜像站点pip install requests -i https://你的镜像站点/simple-i参数的全称是--index-url用来指定 Python 包索引的根地址。注意这里填的是完整的根路径必须以/simple结尾而不是某个具体包的下载链接。如果镜像站点没有配置 HTTPS 证书部分公司内网会触发证书校验错误此时需要追加一个参数pip install requests -i https://你的镜像站点/simple --trusted-host 你的镜像站点--trusted-host的作用是跳过对某个域名证书的校验。这个参数有一定的安全隐患仅在没有更好办法的情况下使用平常不建议加。如果不想每次安装都临时加参数可以把镜像源写成全局配置文件。Windows 下文件位置是%APPDATA%\pip\pip.iniLinux 和 macOS 下是~/.config/pip/pip.conf。文件内容格式如下[global] index-url https://你的镜像站点/simple timeout 60[global]表示这是全局配置段对当前用户所有 pip 操作生效。timeout 60是把单次连接超时时间从默认的 15 秒拉长到 60 秒对网络抖动的情况能起到一定缓冲作用。配置写好后运行pip config list可以验证配置是否被正确读取。这个命令会输出当前生效的配置项列表看到index-url指向你写的镜像地址就说明配置成功了。5. 安装排雷指南五个高频翻车现场与对应解法5.1 双击安装包没反应窗口一直不出现这个现象很常见尤其在公司电脑或装了安全软件的机器上。现象是双击 exe 后鼠标转了几圈但没有任何窗口弹出来任务管理器里也没有 python 进程。原因通常有两个一是下载的安装包不完整虽然文件后缀是 exe但内部数据损坏二是杀毒软件把安装进程拦截了弹窗被静默忽略。解决方法是先核对下载文件的大小到官网下载页对比文件字节数偏差超过 1MB 基本就是损坏包。重新下载时换一个浏览器或者换一条网络尽量避免断点续传。如果文件大小正常下一步右键安装包选择“以管理员身份运行”同时临时关闭杀毒软件的实时保护。装完记得恢复保护。5.2 命令行提示“python 不是内部或外部命令”这个提示是所有 Python 新手遇到的第一座大山。现象是在 cmd 里输入python --version系统直接返回“不是内部或外部命令也不是可运行的程序或批处理文件”。原因是安装时没有勾选 “Add python.exe to PATH”或是安装时勾了但安装完成后没有重新打开命令行窗口导致 PATH 没有刷新。解决方法是重新运行安装程序选择 Modify修改把 “Add python.exe to PATH” 勾上后继续。如果嫌重新跑安装程序麻烦也可以手动把 Python 安装路径加入系统环境变量但需要先找到 python.exe 的位置。此时可以用where python碰碰运气如果这个也提示找不到那就只能重新安装了。5.3 PyCharm 提示 “No Python interpreter selected”现象是新建项目时 Interpreter 一栏是空的或者创建项目后运行代码PyCharm 提示没有配置解释器。原因是安装 PyCharm 之后再安装 Python或者 PyCharm 无法自动发现自定义路径下的 Python。自动发现的逻辑通常只扫描默认路径和 PATH 中的目录如果 Python 装在非默认位置PyCharm 就看不见。解决方法是进入File - Settings - Project - Python Interpreter点击设置齿轮选 Add Interpreter再选 Add Local Interpreter在弹出窗口中选择 System Environment然后在右侧路径栏找到 python.exe 所在位置。选择成功后界面会显示 Python 版本号Run 功能恢复正常。5.4 控制台输出中文变成乱码现象是 print 里的中文在 PyCharm Run 窗口显示为锟斤拷或类似字符。原因是文件编码与控制台编码不一致常见场景是源代码文件保存为 GBK而终端默认按 UTF-8 解码。PyCharm 右下角会显示当前文件的编码标识如果显示的是 “GBK”直接点击它并选择 “UTF-8”然后在弹出提示中选择 Convert。还有一种情况是 Windows 系统的控制台代码页代码页本身是 936也就是 GBKPython 输出 UTF-8 内容时就会乱码。在执行程序前先运行chcp 65001chcp是 Windows 的代码页切换命令65001代表 UTF-8。这个命令只在当前窗口生效不影响全局设置。在 PyCharm 里遇到乱码优先改文件编码因为 PyCharm 的 Run 窗口通常支持 UTF-8。5.5 pip 下载第三方包一直超时失败现象是执行pip install 某个包后进度条反复推进到三分之一处就报Read timed out重试多次依然失败。原因很简单默认的包源在国外跨网访问链路长、丢包率高。这不是 pip 的 bug也不代表网络故障单纯就是链路质量问题。解决方式是使用镜像源。临时方案在 4.3 节已经写过通过-i参数指定镜像地址。或者把镜像源写入全局配置文件一劳永逸。配置完成后不需要重启电脑重新打开命令行窗口即可生效。还有一个小技巧是给 pip 增加超时时间在安装命令后追加--timeout 120这个参数以秒为单位适当调大可以缓解弱网环境下的波动影响。6. 装完不算完把环境调顺手的三件收尾事6.1 用 where python 确认当前生效的解释器装好环境、跑通第一个程序之后我习惯强制自己再走一遍确认流程。打开命令行依次执行where python和python --version用两条命令的结果交叉验证当前默认解释器的版本与路径。这里容易忽略的是 Scripts 目录是否也在 PATH 里pip 实际位于这个目录下如果以后遇到pip 不是内部或外部命令第一反应就去看这个目录有没有加进 PATH。6.2 给 pip 写一份全局配置文件这一步算是我自己的必修课。不管当前网络好不好我都会先把 pip 镜像源写进配置文件避免以后某天临时装包时被超时卡住。Windows 下直接创建%APPDATA%\pip\pip.iniLinux 和 macOS 写~/.config/pip/pip.conf内容就是 4.3 节那个格式。写完之后跑一次pip config list看到自己的配置项再离开。6.3 学会善用 PyCharm 内建的 Terminal最后一件收尾事是打开 PyCharm 底部的 Terminal 面板。这个终端会自动复用当前项目的解释器环境在里面直接执行python xxx.py或pip install xxx不需要手动激活虚拟环境。这一点和 cmd 直接用感觉不一样PyCharm 的 Terminal 加载了项目的运行配置命令运行结果和 IDE 里 Run 按钮的表现完全一致。我早期踩过一个印象很深的坑帮朋友排查环境问题折腾了大半个下午最后发现只是安装时漏勾了 Add to PATH所有报错都指向这一个源头。从那以后我每次装完 Python都会强制自己先跑完三连验证再开 IDE顺手把 pip 配置也写掉。这已经是我的固定流程了也希望能帮到你少走一圈弯路。本文还有配套的精品资源点击获取