
如果你是刚接触编程的新手想在 2026 年把 Python 开发环境装好并顺利写出第一个程序网上其实不缺教程缺的是“能照着做完、不出错”的教程。很多新手在这一步被劝退不是因为 Python 本身难而是因为下载了个假官网的安装包、装完 Python 发现命令行不认识、装完 PyCharm 又配置不好解释器最后折腾两小时连print(Hello)都没跑起来。这篇文章就做一件事把 Python 和 PyCharm 的下载、安装、配置、验证、常见报错全部走一遍全程以 Windows 系统为例步骤尽量细命令直接复制路径和选项都写清楚适合完全零基础的新手。同时我会用一节专门讲 PyCharm 的“激活”问题哪些方式是合法的社区版和专业版怎么选为什么强烈不建议使用来路不明的“激活码”或破解工具。你先搞清楚这些后面才能真正把精力花在学编程上而不是和 IDE 搏斗。1. 新手安装 Python 最容易踩的坑先不看步骤先讲踩坑。因为很多时候你安装失败不是操作问题而是第一步就选错了方向。第一个坑从非官网下载 Python。很多搜索引擎结果里会出现各种“Python 中文版下载”“Python 安装包大全”的站点这些站点有的捆绑广告程序有的版本老旧还有的下载按钮其实是推广链接。正规做法只有一个去 Python 官方网站python.org认准https://www.python.org/downloads/。后面我会教你怎么快速找到真正的下载入口。第二个坑安装时没有勾选 Add Python to PATH。Python 安装包在安装第一步就有一个很不起眼的复选框写着Add python.exe to PATH。如果跳过这一步后面你在命令行里输入python就会提示“不是内部或外部命令”然后你又要花额外时间配置环境变量。这篇文章会特意强调这一步。第三个坑Python 版本选错。现在网上各种教程用到的 Python 版本可能都不一样有 3.7、3.8、3.9、3.10、3.11、3.12甚至 3.13、3.14。如果你下载了一个太新的版本某些第三方库可能还没来得及适配如果太旧又可能缺少新语法支持。从 2026 年的时间点看稳定且兼容性好的方案是选择 Python 官方当前稳定的 3.x 版本不需要追求最新也不要用 2.x。后面我会给出具体建议。第四个坑分不清 Python 和 PyCharm 的关系。经常看到新手问“我装了 PyCharm 是不是就不用装 Python 了”答案是“不是”。Python 是解释器负责运行.py文件PyCharm 是编辑器负责帮你写代码、管理项目、调试程序。你可以在 PyCharm 里写代码但如果没有 Python 解释器PyCharm 根本运行不了程序。这两个东西是配合关系不是替代关系。所以安装顺序一般是先装 Python再装 PyCharm然后在 PyCharm 里指定 Python 解释器。看清这四个坑之后下面进入正式流程。我会把每一步都放上截图级别的说明尽量让你不借助搜索引擎也能独立完成。2. Python 和 PyCharm 分别是什么新手该选哪个版本2.1 Python一门语法简单、应用广泛的编程语言Python 是解释型语言也就是说你写好一个.py文件然后通过 Python 解释器逐行执行。它的语法接近自然语言非常适合入门。实际项目中Python 常用于数据分析、人工智能、自动化脚本、Web 后端开发、爬虫等方向。对新手来说Python 的安装本质是安装一个“解释器程序”。Windows 上安装之后你会得到两个主要命令python和pip。python用来运行代码pip用来安装第三方库。2.2 PyCharm专门为 Python 开发的 IDEPyCharm 是 JetBrains 公司出品的 Python 集成开发环境。IDEIntegrated Development Environment集成开发环境可以理解为“写代码的工作台”它把代码编辑、运行、调试、文件管理、终端、版本控制整合在一起。没有 IDE 也能写 Python比如用记事本写完.py文件再在命令行执行python xx.py但调试体验和工程管理体验都比较差。PyCharm 非常适合初学者因为它对 Python 项目的结构理解是开箱即用的。PyCharm 有两个版本Community社区版和Professional专业版。对比项Community 社区版Professional 专业版价格免费商业收费可试用主要功能Python 开发、调试、测试、Git 集成社区版功能 Web 框架Django/Flask、数据库工具、远程开发适合人群Python 入门、脚本开发、数据分析Web 开发、全栈开发、需要数据库和远程部署的开发者学习资源官方支持完善功能更丰富但新手用不到我的建议是新手阶段直接使用 Community 社区版即可。它的功能已经足够支撑你把 Python 语法、基础项目、爬虫、自动化、数据处理这些都跑起来。至于专业版等以后真正需要做 Web 项目或远程开发时再考虑也不迟。2.3 版本选型Python 3.x不要纠结最新版到 2026 年Python 2.x 早已停止维护不用考虑。Python 3.x 是唯一需要关注的系列。在python.org下载页面一般默认突出推荐的最新稳定版本。如果你是纯新手选择官方标注的“Latest Python 3 Release”即可但也要考虑第三方库兼容性如果某些常用库还没有适配最新 Python可以退而选择再早一个的小版本。这里给一个稳妥策略优先使用官方推荐的最新稳定版本但安装时留意第三方库的支持情况。例如你后面要学 pandas、requests、Django如果这些库已经声明支持当前 Python 版本那就放心直接用如果不确定一个相对保守的选择是使用 Python 3.11/3.12 这样的主流版本。因为文章的实操步骤不依赖某个特殊新特性所以你安装哪一个稳定版本都能跟着做完。3. 环境准备与前置检查在下载安装之前先花两分钟检查你的电脑现状可以避免很多弯路。3.1 Windows 版本要求文章以 Windows 10 或 Windows 11 为例。Python 官方安装包对这两个系统支持都很好。如果你的系统是 Windows 7安装新版本 Python 可能不受支持建议先升级系统或者选择兼容的旧版本。从安全角度考虑也建议使用仍受官方支持的操作系统。3.2 检查是否已经安装过 Python打开开始菜单输入cmd回车打开命令行窗口然后输入python --version如果输出类似Python 3.11.4说明你电脑里已经有 Python 了。这时要注意版本是不是你需要的如果不是可以安装新版本但要注意环境变量优先级问题。如果提示python 不是内部或外部命令也不是可运行的程序或批处理文件。说明当前系统中没有 Python或者没有加入 PATH可以继续后面的安装。同理可以通过命令检查pippip --version3.3 检查是否已经安装过 PyCharm如果你之前装过 PyCharm但一直没用起来建议先卸载干净避免多个版本冲突。卸载后可以继续安装新版。如果没装过忽略这一步即可。3.4 网络和下载源国内下载 Python 官方安装包时速度有时会比较慢但一般可以接受。如果官网下载特别慢可以前往python.org的国内镜像站不过更推荐直接在官网选择下载因为最安全。如果你在公司或学校网络环境需确保可以正常访问外网。4. Python 下载与安装详细步骤4.1 打开 Python 官网找到下载入口浏览器打开https://www.python.org/鼠标移动到顶部导航栏的Downloads菜单会自动展开一个下拉菜单。如果是 Windows 系统直接点击里面的Windows选项。进入 Windows 下载页面后页面会展示各个 Python 版本的安装包。你会在页面中看到类似Python 3.13.x或者Python 3.12.x的版本列表。对于 64 位 Windows建议下载Windows installer (64-bit)也就是.exe格式的安装程序。认准文件名中带64-bit和.exe的那一项。如果不知道自己的电脑是 64 位还是 32 位一般现在主流电脑都是 64 位。32 位系统下载32-bit的安装包也可以运行但后续一些依赖库会少一些。文件名示例python-3.13.x-amd64.exe其中的3.13.x是具体版本号amd64表示 64 位。4.2 安装 Python最关键的一步勾选 PATH双击下载好的.exe安装包会进入 Python 安装向导。这里要重点强调安装界面最底部有一个复选框Add python.exe to PATH一定要勾选。我见过太多新手在这里漏掉勾选导致安装完 Python 后在命令行里执行python报错。勾选这一项后安装程序会自动把 Python 的可执行文件路径加到系统环境变量中后续你在任何目录打开终端都能直接使用python命令。勾选完成后点击Install Now即可。安装过程一般需要一两分钟。建议使用默认安装路径比如C:\Users\你的用户名\AppData\Local\Programs\Python\Python313\不需要手动改路径因为默认路径通常没有中文后续使用更省心。如果电脑上有多个 Python 版本安装时也可以选择Customize installation自定义安装路径方便区分。安装完成后安装向导会显示Setup was successful类似字样并提供一个Disable path length limit的选项点击它可以解除 Windows 路径长度限制。这一步不是必须但建议点击一下避免以后某些第三方包安装时因为路径过长报错。4.3 验证 Python 安装是否成功安装完成后重新打开一个新的命令行窗口这一步很关键旧窗口可能读不到新环境变量输入python --version预期输出Python 3.13.x再输入pip --version预期输出类似pip 25.x from C:\Users\你的用户名\AppData\Local\Programs\Python\Python313\Lib\site-packages\pip (python 3.13)如果两个命令都能正常输出版本号说明 Python 环境已经初始化完成。把这两个验证命令放在一起python --version pip --version如果python命令不被识别请回看第 4.2 节确认是否勾选了Add python.exe to PATH。也可以在 Windows 搜索栏输入“编辑系统环境变量”打开后点击“环境变量”查看Path中是否已经有 Python 安装路径。没有的话可以手动添加路径就是 Python 安装目录。5. PyCharm 下载与安装详细步骤5.1 打开 PyCharm 官网并选择版本PyCharm 的官方网站是 JetBrains 公司旗下站点地址是https://www.jetbrains.com/pycharm/。进入官网首页后点击页面顶部或中间的Download按钮进入下载页面。下载页面会提供两个平台版本Windows、macOS、Linux。你根据自己系统选择 Windows。版本上提供 Professional专业版和 Community社区版。对新手来说这里直接选择Community下方的Download按钮。不要被 Professional 的丰富功能吸引社区版免费且满足基础学习需求。5.2 双击安装包按向导安装下载完成后一般是一个.exe文件文件名类似pycharm-community-2026.x.exe双击运行进入安装向导。安装过程中有几个可选配置建议这样设置Create Desktop Shortcut创建桌面快捷方式建议勾选方便以后启动。Update PATH variable添加安装目录到 PATH建议不勾选。PyCharm 不像 Python 那样需要通过命令行调用不需要加入 PATH。Create Associations关联.py文件建议勾选以后双击.py文件可以直接用 PyCharm 打开。安装路径默认在C:\Program Files\JetBrains\可以保持默认也可以改成自己习惯的目录但同样建议不要使用中文路径防止后面出现编码或权限问题。安装完成后点击Finish退出安装向导。5.3 首次启动 PyCharm 的设置项第一次启动 PyCharm 时会弹出一些配置选项例如Import PyCharm Settings如果你之前没有用过 PyCharm选择Do not import settings。UI Theme选择你喜欢的主题默认即可后面也能随时修改。Create New Project/Open这一步先不要急着创建项目直到确认解释器配置正确见第 7 节。如果你打开后一直卡在加载界面可以检查电脑是否满足 PyCharm 的最低内存要求。一般来说内存 8GB 以上运行比较流畅4GB 也能用但可能会卡。6. 关于 PyCharm 激活合法路径与重要提醒这个部分是很多新手最关心的搜索关键词里也大量出现“PyCharm 激活码”“PyCharm 永久激活”。我必须先给你一个明确判断PyCharm 是商业软件社区版是免费的专业版需要购买授权。任何通过破解补丁、盗版激活码、非法授权服务器来“激活”专业版的方式都存在法律和网络安全风险我不推荐也不提供任何相关工具或教程。6.1 社区版本来就免费如果你选择 Community 社区版安装后直接就能用不需要激活。打开 PyCharm 后进入帮助菜单可以查看版本信息社区版是Community Edition它不会要求你输入激活码。6.2 专业版可以免费试用如果你确实需要专业版的功能例如 Django/Flask 的 Web 项目模板、数据库连接工具JetBrains 官方提供 30 天免费试用。安装 Professional 版后在启动界面选择Start trial然后用 JetBrains 账号登录即可。试用期内功能完整适合短期项目评估。6.3 教育用途可以申请免费授权学生和教师可以通过 JetBrains 官方教育计划申请免费的全系列产品授权。如果你是在校学生或老师可以前往 JetBrains 官网提交教育认证申请通过后可以免费使用专业版。这个渠道是合法且免费的比到处找激活码靠谱得多。6.4 商业使用建议购买正版订阅如果以后你进入公司做 Python 开发公司一般会为开发者购买 JetBrains 正版订阅。个人开发者如果业务收入来自 Python 项目也应该购买专业版订阅价格可以在官网查询。把买软件看作对自己工具链的投资能避免很多安全隐患。6.5 为什么不建议使用来路不明的“激活码”网上的“激活码”大多来自非官方渠道可能存在以下问题一是无效许多激活码很快被官方封禁二是捆绑风险不少“激活工具”本身是木马或后门程序可能盗取你的账号密码三是失去官方更新和技术支持长远看反而更费事。所以正确态度是新手用社区版需要专业版先试用学生/教师走教育授权公司项目由公司购买授权。7. 在 PyCharm 中配置 Python 解释器并创建第一个项目环境都装好之后现在要做的是把两者连接起来。这步是新手最容易困惑的地方明明 Python 装好了PyCharm 也装好了但创建项目后运行按钮是灰色或者运行时报错提示找不到解释器。原因是 PyCharm 不知道用哪一个 Python 来执行你的代码。7.1 创建新项目打开 PyCharm点击首页的New Project按钮。在Location处选择项目存放目录和项目名比如D:\PythonProjects\hello_demoLocation最后一个路径段就是项目名PyCharm 会自动创建目录。在Project Interpreter或Python Interpreter配置区域选择刚才安装的 Python 版本。PyCharm 一般会自动检测到系统里已有的 Python并显示类似Python 3.13 (C:\Users\你的用户名\AppData\Local\Programs\Python\Python313\python.exe)如果没有自动检测到可以点击右侧设置按钮选择Add Interpreter-Add Local Interpreter找到 Python 安装目录下的python.exe。关于是否勾选Create a main.py welcome script新手建议勾选这样创建项目后会自动生成一个main.py可以直接运行看到效果。7.2 编写第一个 Python 程序创建项目后左边文件树里会看到main.py双击打开在编辑器里输入# 文件路径hello_demo/main.py print(Hello, Python!) print(这是我在 PyCharm 里运行的第一个 Python 程序。)输入完成后可以看到代码上方或右键菜单有一个绿色三角形运行按钮。点击它运行。7.3 运行与查看输出运行后PyCharm 底部会打开一个Run面板里面显示C:\Users\你的用户名\AppData\Local\Programs\Python\Python313\python.exe D:\PythonProjects\hello_demo\main.py Hello, Python! 这是我在 PyCharm 里运行的第一个 Python 程序。 Process finished with exit code 0看到Process finished with exit code 0表示程序正常运行结束0代表没有错误。如果显示exit code 1或者其他非零值说明运行过程中出了异常可以在Run面板查看具体错误信息。把运行脚本的命令单独放在命令行里演示一下python main.py在项目目录下执行这个命令会得到同样的输出。这说明了 PyCharm 本质上是替你执行了python main.py只是在图形界面里帮你整合了所有步骤。8. 使用 pip 安装第三方库从 requests 讲起Python 真正的威力来自第三方库。新手装完 Python 后下一个高频需求就是“我用 pip 装一个库”。但很多教程默认你懂 pip结果你在命令行里输入pip install requests时可能遇到下载慢、超时、找不到包等问题。这里我把这一流程也讲透。8.1 pip 是什么pip 是 Python 官方的包管理工具。使用 Python 的任何版本安装器都会自带 pip。它的作用是从 Python 官方软件仓库PyPIPython Package Index下载并安装第三方库。你不需要手动去官网下载库文件只需要一行命令pip install requests这里requests是 Python 一个非常常用的 HTTP 请求库。安装成功后你就可以在代码里import requests使用它。8.2 国内镜像源加速默认情况下pip 从国外 PyPI 服务器下载速度可能较慢。解决办法是临时指定国内镜像源。以清华镜像为例pip install -i https://pypi.tuna.tsinghua.edu.cn/simple requests其他可用镜像源包括阿里云、腾讯云、中科大等用法相同。如果希望永久配置默认源可以执行下面的命令pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple之后再执行pip install命令就会自动走清华镜像不再需要每次都加-i参数。8.3 批量安装依赖requirements.txt在真实项目里一个项目往往依赖很多第三方库。规范的用法是生成一个requirements.txt文件记录所有依赖项。你可以手动创建这个文件内容形如requests2.32.3 numpy2.0.0然后在命令行里安装pip install -r requirements.txt如果是把自己的环境依赖导出到文件可以使用pip freeze requirements.txt这种做法在团队协作和项目迁移时非常有用。8.4 使用 requests 库写一个最简单的请求示例安装好 requests 后在 PyCharm 里新建一个 Python 文件例如http_demo.py# 文件路径hello_demo/http_demo.py import requests response requests.get(https://www.python.org) print(HTTP 状态码, response.status_code) print(网页标题, response.headers.get(Content-Type))运行该文件预期输出类似HTTP 状态码 200 网页标题 text/html; charsetutf-8状态码200表示请求成功。如果遇到网络错误或 SSL 报错可以先检查网络环境再检查 Python 和 requests 库版本是否正常。9. 常见问题与排查思路新手从下载到跑通第一个程序大概率会在某些环节被卡住。这里整理了我所见过的最高频问题按“现象、原因、排查、解决”结构列出方便你直接对照。问题现象可能原因排查方式解决方案python不是内部或外部命令安装时没有勾选 Add Python to PATH输入python --version看是否报错重新安装并勾选 PATH或者手动在环境变量中添加 Python 目录pip不是内部或外部命令pip 未加入 PATH 或 Python 安装损坏输入python -m pip --version看是否能输出使用python -m pip调用如果失败则重装 PythonPyCharm 运行按钮是灰色没有配置 Python 解释器打开 Settings - Project - Python Interpreter 查看是否为空点击 Add Interpreter选择本地 Python 解释器运行时报 No module named requests库没有安装到当前解释器环境在 PyCharm 终端执行pip list安装 requests 库注意安装的目标环境要与当前解释器一致pip 下载速度慢或超时网络访问 PyPI 不稳定观察错误信息是否 timeout使用国内镜像源或设置 pip 默认源Python 安装提示磁盘空间不足系统盘空间紧张检查 C 盘剩余空间清理磁盘或者自定义安装到其他盘PyCharm 启动后卡在加载页面内存不足或配置损坏查看 JetBrains 日志重启电脑尝试重新安装或升级内存双击.py文件不是用 Python 打开文件关联错误右键.py文件查看打开方式在 PyCharm 中勾选文件关联或手动设置默认打开方式安装第三方库时提示“externally-managed-environment”Python 3.11 或某些环境启用了 PEP 668 管理策略查看错误提示中的具体说明创建虚拟环境后在虚拟环境中安装或使用系统的包管理器不要强制覆盖系统环境9.1 命令行报错pip 与 python 版本不匹配如果你电脑里装过多个 Python 版本直接使用pip可能会装到旧版本的 Python 环境中。更稳妥的调用方式是使用python -m pippython -m pip install requests这可以确保 pip 与当前python命令指向的解释器一致避免“库装到了 A 版本PyCharm 用的是 B 版本”这种问题。9.2 环境变量修改后没有生效Windows 环境变量修改后当前已打开的命令行窗口不会自动读取新值。务必关闭旧的命令行窗口重新打开一个新的终端窗口再执行python --version。如果还不行可以注销再登录系统或者在 PyCharm 中重启终端。10. 最佳实践与工程建议环境装好、能跑 Hello World、能装第三方库这只是开始。要让 Python 开发体验长期顺畅下面几条建议值得从第一天就养成。10.1 永远不要使用中文路径和中文用户名目录虽然现在的 Python 和 PyCharm 对中文路径支持比过去好但在安装第三方包和运行某些工具时中文路径仍然可能触发编码或权限问题。建议项目目录、Python 安装目录、PyCharm 安装目录都使用英文路径。如果你的 Windows 用户名本身就是中文尽量把项目放在非用户目录下比如直接放在D:\PythonProjects。10.2 学会使用虚拟环境虚拟环境是 Python 项目隔离依赖的标准方案。每个项目创建独立的虚拟环境项目 A 用了 requests 2.x项目 B 用了 requests 1.x它们互不干扰。创建虚拟环境很简单python -m venv venvWindows 下激活虚拟环境venv\Scripts\activate激活后命令行前面会出现(venv)前缀此时通过pip install安装的包都会进入这个虚拟环境而不是全局环境。PyCharm 在创建新项目时Python 3.8 以上版本会默认生成一个虚拟环境你要做的是确认它已经创建并选中而不是忽略它。使用虚拟环境可以避免很多“昨天还能跑今天突然报错”的依赖问题。10.3 坚持在 PyCharm 底部 Terminal 中执行命令PyCharm 自带终端默认会自动激活当前项目的虚拟环境。运行 pip 命令时建议直接在 PyCharm 的Terminal面板操作这样能保证 pip 安装的目标就是当前项目使用的解释器。不要在外部随便打开一个命令行然后抱怨“为什么装完库 PyCharm 里还是 import 不到”。10.4 定期关注 Python 和 PyCharm 的官方更新Python 和 PyCharm 都会定期发布新版本修复安全漏洞、增加新特性。建议不要频繁追最新版本但也不要长期停留在过旧版本。如果某个项目已经稳定运行没有特殊需求就不要轻易升级新项目则可以使用当前稳定版。10.5 换源后用pip list验证环境当你发现某个库安装后无法导入第一步不是在代码里反复调试而是打开终端执行pip list查看这个库是否真的在当前环境里。如果不在说明安装目标错了如果在再看版本是否正确。这个排查思路能省下大量时间。10.6 学习阶段多写多跑不要过度追求 IDE 技巧新手阶段花一点时间了解 PyCharm 的常用快捷键即可比如Shift F10运行当前脚本、Ctrl Alt L格式化代码、双击Shift全局搜索。把更多时间花在写代码、理解语法、做小项目上。工具是辅助语言本身才是你真正要学的东西。11. 总结与下一步实践路径到这一步你应该已经完成了Python 安装、PyCharm 安装、解释器配置、第一个 Python 程序运行、第三方库安装。这五个环节是 Python 开发环境的最小全集。所有 Python 新手如果能在一天内走到这里就已经超过了不少卡在环境问题上的同学。接下来建议你按这样的路径继续练习先完成 Python 基础语法变量、条件判断、循环、函数、列表、字典然后用 PyCharm 做一两个小练习比如“计算器”“猜数字游戏”或者“从网页抓取标题”。这些项目会不断用到你刚装好的环境和工具也会让你真正感受到“写出代码并运行成功”的正反馈。我在每一节里反复强调版本、PATH、解释器、虚拟环境这些概念是因为它们恰恰是新手环境配置失败的重灾区。如果你在实操中遇到哪一步卡住回过头对照第 9 节的问题排查表大多数问题都能找到答案。把这篇文章收藏备用以后换电脑、重装系统时照着再做一遍即可。最后再提醒一次PyCharm 社区版免费专业版可以合法试用或购买学生教师可以走教育授权。不要使用破解工具这是对自己电脑安全和职业习惯最好的保护。工具装好了接下来就看你的代码了。