简介：面向 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 的安装目录加进 PATH，cmd 里敲 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 python

where是 Windows 自带的文件查找命令，作用是遍历 PATH 里的所有目录，找出python.exe的实际位置。正常会输出一两条路径，第一条就是命令行实际调用的那个解释器。这一步的意义在于确认你跑的命令到底用的是哪一份 Python，尤其是以后装多版本时，这个命令能帮你快速定位冲突。

python

不加任何参数直接执行python，会进入 Python 的交互式解释器（REPL），屏幕显示版本信息和>>>提示符。到这里exit()回车退出即可。这一步验证的是安装包的功能完整性，有些安装包虽然能显示版本号，但进入交互模式后闪退，说明解释器本身有损坏，需要重新安装。

三连验证全部通过后，Python 本体才算真正装好了。需要注意的是：如果你在安装完成后才打开新的命令行窗口，上面的命令才能生效，因为 PATH 是在打开窗口那一刻被读取的。

2.4 多个 Python 并存时怎么查默认解释器

如果电脑上原本就有另一个 Python，或者系统里预装了 Microsoft Store 版 Python，命令行命中的可能是旧版。遇到这种情况，优先用命令确认当前生效的解释器路径而不是盲敲python --version。

py --list

py是 Windows 自带的 Python launcher，它专门管理同一台电脑上的多版本 Python。--list参数会列出所有已注册的 Python 版本，每行前面带*的是默认版本。这个命令比where python更可靠，因为它看的是版本注册表，而不是 PATH 里的文件顺序。

如果发现默认版本不对，常见做法是卸载旧版本，或者手动调整系统环境变量 Path 里的顺序。新手阶段不建议深入折腾，先保证只有一个 Python 在 PATH 里即可。

3. PyCharm 装配：社区版与专业版选型、首次启动与解释器关联

3.1 下载前先想清楚：Community 版还是 Professional 版

PyCharm 的下载页在官网上，提供两个版本：Community（社区版）和 Professional（专业版）。很多教程默认让新手下载专业版，但专业版是付费的，并且它多出来的主要功能——远程调试、数据库工具、Docker 集成——在入门阶段大概率一个都用不上。

社区版和专业版的差异可以用一张表说清楚：

我的建议是最新安装 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.ini，Linux 和 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，也就是 GBK，Python 输出 UTF-8 内容时就会乱码。在执行程序前先运行：

chcp 65001

chcp是 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.ini，Linux 和 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 配置也写掉。这已经是我的固定流程了，也希望能帮到你少走一圈弯路。

本文还有配套的精品资源，点击获取