新手学 Python头两个小时大概率不是在写代码而是在跟“环境配置”较劲。Python 官网下载太慢、装完提示python 不是内部或外部命令、PyCharm 下载了打不开、代码能写但跑不起来……这些问题几乎每个初学者都会遇到。这一篇就把 2026 年版 Python 和 PyCharm 的下载、安装、配置、验证、跑通第一个程序完整走一遍。全程按零基础视角写不预设你会用命令行也不预设你懂什么编程术语。文章里会用大量表格、步骤和排查清单跟着操作基本不会卡住。1. 核心能力速览这篇教程不是教你背命令而是带你完整走一遍 Python 开发环境从零到能跑的流程。下面先看一下整篇内容覆盖的关键模块。模块说明Python 版本选择2026 年建议选 3.11 以上的稳定版本支持 Win / macOS / Linux安装方式官网下载安装包勾选Add Python to PATH避免手动配环境变量验证方式命令行执行python --version和pip --versionPyCharm 版本新手建议用 Community 社区版免费、可商用、无激活门槛配置解释器在 PyCharm 里选择已安装的 Python 3.x 作为项目解释器中文界面通过 PyCharm 插件Chinese Language Pack切换中文包管理使用pip install安装 pandas / requests / numpy 等常用库常见报错python 不是内部命令、pip 不是内部命令、解释器缺失、源下载慢看完这篇你能独立完成Python 安装、PyCharm 安装、建项目、写第一段 Python 代码、安装第三方库并且知道最常见的报错怎么解决。2. 这篇教程适合谁读先明确一件事这个教程面向的是零基础 Python 入门用户不是给老手看的进阶指南。适合以下三类读者刚决定学 Python还没装过任何开发环境之前按网上教程装过但运行python --version报错环境变量没配好准备用 PyCharm 写 Python 脚本、做数据分析、写爬虫或者练算法题需要一套干净可用的开发环境。如果你已经熟悉命令行、会装 Anaconda、也能独立配置解释器那这篇内容对你来说偏基础可以直接跳到第 9 章看 pip 换源和常见报错。这里要强调的是Python 只是解释器PyCharm 只是编辑器两者是两套独立的软件。很多人混着下载最后发现 PyCharm 能打开但解释器没配置一运行就报No Python interpreter configured。下面第 4 到第 8 章就是围绕这条主线展开的。另外提醒一个比较实际的问题网上搜“PyCharm 激活码”“PyCharm 永久激活”出来的内容很多涉及破解工具这类渠道既不稳定也不安全轻则激活失败、软件被锁重则下到捆绑木马。PyCharm 社区版本身完全免费官方长期维护所有功能对新人完全够用不建议在入门阶段碰任何破解和激活码渠道。3. 安装前的准备与版本选择安装之前先把版本和来源弄清楚这一步能省掉后面很多麻烦。3.1 Python 版本怎么选打开 Python 官网python.org下载页面通常并列着 Python 3.13、3.12、3.11 等版本。2026 年推荐的判断标准是选 3.11 或更新版本的稳定发布版不要选 rc 版、beta 版这类预览版本安装包按系统区分Windows 选Windows installer (64-bit)macOS 选macOS 64-bit universal2 installerLinux 多半用系统包管理器安装不要贪图最新。如果学习资料用的版本是 3.9 或 3.10你装 3.12 也完全兼容绝大多数 Python 基础语法和常用库不受影响。3.2 PyCharm 两个版本怎么选PyCharm 官网jetbrains.com/pycharm提供两个版本版本价格定位适合人群Community 社区版免费Python 基础开发、调试、测试新手、学习、轻度开发Professional 专业版收费/试用Web 框架、数据库、远程开发职业开发、全栈开发新人安装 Community 版就够了社区版支持 Python 开发最核心的代码补全、调试、运行、Git 集成学习阶段不需要专业版功能。Professional 版本有 30 天免费试用试用结束后要付费订阅这个过程完全走官方渠道不要去搜破解或非法激活码。3.3 安装前检查清单检查项说明系统版本Windows 10/11、macOS 12建议提前更新系统补丁磁盘空间Python 安装包约 30MBPyCharm 约 600MB预留 5GB 以上更稳妥网络环境官网下载一般较慢必要时可换镜像源下载旧版本残留如果之前装过 Python建议先卸载干净再装新版管理员权限Windows 安装 PyCharm 时如果是为当前用户安装一般不需要管理员权限4. Python 下载与安装4.1 官网下载步骤访问 Python 官网python.org把鼠标放在顶部导航栏的Downloads系统会自动识别你当前的操作系统直接点击下载按钮即可。需要手动选版本的话进入Downloads Windows或Downloads macOS页面找到对应版本的安装包。Windows 用户下载时需要选择Windows installer (64-bit)。如果你的电脑是老式 32 位系统选 32-bit 版本但 2026 年的 Windows 机器基本都是 64 位系统了。4.2 Windows 安装关键步骤双击运行下载好的.exe文件安装界面出来之后先做两件事底部勾选Add python.exe to PATH点击Install Now进入默认安装流程。Add Python to PATH这个选项是新手最容易漏掉的一步。如果安装时没勾后面在命令行敲python会出现python 不是内部或外部命令需要手动配环境变量非常麻烦。漏掉也没关系第 10 章会给出补救方案。安装过程持续一到三分钟最后看到Setup was successful表示安装完成。macOS 用户安装.pkg文件后Python 会默认安装到系统目录通常不需要手动配置 PATH但建议在终端里验证一下。Linux 用户使用 apt、yum、dnf 等包管理器安装命令示例# Ubuntu/Debian 系 sudo apt update sudo apt install python3 python3-pip # CentOS/RHEL 系 sudo yum install python3 python3-pip5. 验证 Python 环境是否安装成功5.1 命令行验证Windows 按Win R输入cmd回车打开命令提示符输入以下命令python --version如果输出类似Python 3.12.x说明安装成功。再输入pip --version如果输出类似pip 24.x from C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\site-packages\pip (python 3.12)说明包管理工具也可用。macOS 打开终端输入python3 --version pip3 --version注意 macOS 上默认命令可能是python3而不是python这是因为 macOS 本身自带了旧版 Python 环境使用python3可以避免和系统自带的版本冲突。5.2 遇到报错怎么判断命令可能的报错含义python --version不是内部或外部命令环境变量未配置python --version弹出 Windows 商店界面系统进入了应用执行别名pip --version不是内部或外部命令pip 未加入 PATHpython --version报错信息很长提示 msvcp 缺失系统缺少 VC 运行库这些报错第 10 章会逐个给出排查方法不要现在就慌。最常见的原因就是环境变量没有配置好配好之后基本能解决 90% 的问题。6. PyCharm 下载与安装6.1 官网下载访问 PyCharm 官网jetbrains.com/pycharm点击页面上的Download按钮。版本选择页面会列出 Community 和 Professional 两个选项选择 Community 社区版点击下载适用于你系统的安装包。Windows 用户下载.exe安装包macOS 用户下载.dmg文件。6.2 Windows 安装步骤双击安装包第一页点击Next选择安装路径建议保持默认路径不要装在中文目录下否则某些第三方工具和插件可能会因为中文路径出现兼容性问题。接下来这一步有几个安装选项选项建议创建桌面快捷方式建议勾选方便启动添加Open Folder as Project到上下文菜单可选不影响使用添加 bin 目录到 PATH不推荐勾选PyCharm 不需要加入 PATH关联.py文件可选新手建议勾选双击.py文件可以直接用 PyCharm 打开点击Next选择开始菜单文件夹点击Install等待安装完成最后勾选Run PyCharm并点击Finish启动软件。macOS 用户把PyCharm图标拖入Applications文件夹即可完成安装。首次打开如果系统提示“来自身份不明的开发者”需要在系统设置 隐私与安全性中点击允许这是 macOS 对新安装软件的正常拦截不是软件问题。6.3 首次启动设置第一次打开 PyCharm 会进入初始设置页面选择主题风格喜欢深色选Darcula喜欢浅色选IntelliJ Light组件可以全部不安装直接点击Start Using PyCharm如果之前装过旧版 PyCharm会询问是否导入旧设置新手选Do not import settings即可。7. PyCharm 配置 Python 解释器PyCharm 本身不包含 Python它只是编辑器必须告诉它“你项目里的代码用哪个 Python 解释器运行”。这一步新手经常忽略导致运行时报错。7.1 新建项目打开 PyCharm 首页点击New Project进入项目创建界面。你需要关注这几个字段字段填写内容Location项目存放路径建议建一个英文目录例如D:\PythonProjects\helloLanguagePythonInterpreter type选择Custom Environment或Existing指向你已安装的 PythonInterpreter 路径选择 Python 安装目录下的python.exeWindows或python3macOS/Linux如果你在Interpreter type里选择VirtualenvPyCharm 会基于你指定的 Python 给当前项目创建一个独立的虚拟环境这是比较推荐的默认方式不同项目的依赖包不会被互相污染。Windows 默认 Python 安装在C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\python.exemacOS 通常安装位置/usr/local/bin/python3选择好解释器之后点击CreatePyCharm 会创建项目结构和虚拟环境底部的进度条是Creating virtual environment等待几秒即可进入主界面。7.2 配置中文界面插件PyCharm 默认英文界面英文不好也不用担心JetBrains 官方提供了中文语言包插件完全免费。进入 PyCharm 主界面后点击菜单栏File Settings左侧找到Plugins在Marketplace市场搜索框中输入Chinese Language Pack找到由 JetBrains 发布的插件点击Install安装。安装完成后点击Restart IDEPyCharm 重启之后菜单和界面就会变成简体中文。如果没有搜索到中文插件检查一下 PyCharm 版本是否为 2020.1 以上旧版本不支持官方中文语言包。7.3 验证解释器是否配置成功在 PyCharm 顶部菜单选择文件 设置 项目 Python 解释器右侧窗口中应该能看到 Python 3.12 以及它所包含的包列表。如果这里显示的是No Interpreter说明解释器没有正确选择点击齿轮图标选择Add Local Interpreter重新指定 Python 路径。8. 第一个 Python 程序Hello World 测试环境配置完成后马上写第一个程序验证整条链路是否畅通。8.1 新建 Python 文件在 PyCharm 左侧项目目录右键选择新建 Python 文件输入文件名helloPyCharm 会自动创建hello.py文件后缀不用手动输入。在这个文件里输入print(Hello Python) print(PyCharm 环境配置成功)8.2 运行程序点击hello.py文件编辑区右上角的绿色三角按钮或者在编辑区右键选择运行 hello底部会打开运行窗口输出Hello Python PyCharm 环境配置成功 进程已结束退出代码为 0看到退出代码为 0就说明程序正常结束没有报错。如果运行时弹出No Python interpreter configured for the project回到第 7 章重新配置解释器。如果解释器配置正确但运行按钮是灰的检查项目是否创建成功或者文件是否在项目目录内。8.3 用命令行运行实验除了在 PyCharm 里运行命令行运行也需要验证一下。在系统命令行中切换到hello.py所在目录执行python hello.pyWindows 下如果文件在D:\PythonProjects\hello\hello.py先执行d: cd D:\PythonProjects\hello python hello.py这样能确认命令行环境下 Python 也可用以后使用 pip 安装包、运行脚本都不会有问题。9. 常用包安装与 pip 换源Python 真正强大的地方在于第三方库。新手安装量最大的几个库是pandas、numpy、requests、matplotlib。安装方式都是同一个命令。9.1 安装 pandas 示例在 PyCharm 底部打开终端Terminal输入pip install pandas等待下载、安装完成最后出现Successfully installed pandas-x.x.x numpy-x.x.x字样说明安装成功。查看已安装的包pip list这个命令会列出当前环境里所有已安装的包。如果在命令行执行pip报错但在 PyCharm 终端里能正常执行原因通常是 PyCharm 终端自动激活了当前项目的虚拟环境而你系统全局的 Python 环境变量没有配好排查方向要区分开。9.2 国内网络慢就换 pip 源默认情况下 pip 从官方 PyPI 源下载国内网络可能很慢或超时。换用国内镜像源可以显著提升速度。常用的镜像源包括清华源、阿里源、腾讯源。使用方式给镜像源指定参数以清华源为例pip install pandas -i https://pypi.tuna.tsinghua.edu.cn/simple如果希望长期使用可以一次性修改全局配置。Windows 下在C:\Users\你的用户名目录下创建pip文件夹再创建pip.ini文件内容写[global] index-url https://pypi.tuna.tsinghua.edu.cn/simple trusted-host pypi.tuna.tsinghua.edu.cnmacOS 和 Linux 配置路径为~/.pip/pip.conf。9.3 验证第三方库可用写一个小测试代码导入并打印版本import pandas as pd print(pd.__version__)运行后输出类似2.x.x的版本号说明 pandas 安装成功且可以被 Python 导入。新手必须区分pip 安装成功和Python 能导入是两回事——常见坑是用了命令行全局 pip 装包但 PyCharm 项目用的是虚拟环境两个环境互相看不到。解决方式是在 PyCharm 的终端里运行 pip 命令让它装进当前项目环境。10. 常见问题与排查方法新手阶段大部分报错集中在环境变量、解释器选择、pip 源这几个方面。下面把出现频率最高的问题整理成一张排查表。问题现象可能原因排查方式解决方案python 不是内部或外部命令Python 未加入 PATH命令行执行where python查看是否存在重新安装时勾选Add Python to PATH或手动配置环境变量pip 不是内部或外部命令pip 未加入 PATH或 Python 未安装成功命令行执行python -m pip --version执行python -m ensurepip --upgrade或用python -m pip install 包名运行 python 弹出 Windows 商店系统开启了应用执行别名检查设置 应用 应用执行别名关闭 python.exe和 python3.exe 的别名开关PyCharm 里运行时提示无解释器新建项目时没有选择 Python查看文件 设置 项目 Python 解释器点击齿轮图标添加本地解释器选择 python.exepip 安装速度极慢或超时默认访问官方 PyPI 源观察卡在 downloading 阶段使用-i参数切换国内镜像源安装包显示 Successfully installed 但 PyCharm 导入失败安装在全局环境项目用的是虚拟环境PyCharm 终端执行pip list查看包是否存在切换到项目终端再安装或检查解释器路径是否一致PyCharm 中文插件搜索不到版本过低或网络问题查看帮助 关于确认版本更新 PyCharm 到 2020.1 以上并检查网络项目路径含中文导致编译报错系统编码和工具链兼容问题查看报错路径是否包含中文重新建项目路径使用英文目录提示需要安装缺失的节点未安装项目所需的第三方模块查看终端或日志提示的包名在项目终端执行pip install 缺失的包名新装 Python 后 PyCharm 仍指向旧解释器本地存在多个 Python 版本在解释器设置中查看路径在项目设置中重新选择目标 Python 路径10.1 手动配置环境变量补丁如果之前安装时没有勾选Add Python to PATH可以用下面的方式补救。Windows打开此电脑右键选择属性点击高级系统设置点击环境变量在系统变量或用户变量里找到Path点击编辑新建两条记录Python 安装目录以及它的Scripts子目录例如C:\Users\你的用户名\AppData\Local\Programs\Python\Python312 C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\Scripts保存后重新打开命令行执行python --version pip --version只要看到版本号说明环境变量生效。macOS 的 PATH 一般由安装器自动配置如果命令未生效可以在~/.bash_profile或~/.zshrc中追加export PATH/usr/local/bin:$PATH然后执行source ~/.zshrc10.2 区分系统 Python 和虚拟环境 Python这是新手最混乱的一个点。PyCharm 新建项目时默认创建venv虚拟环境虚拟环境里有一个独立的python.exe与系统全局 Python 不共用第三方库。查看当前使用哪个 Python可以在 PyCharm 终端中执行which pythonWindows 平台把which换成where。输出里的路径如果不是全局 Python 路径而是venv目录下的 Python就说明你在虚拟环境中。这个行为是刻意设计的保证项目依赖隔离。遇到包安装到全局但项目导入不了不需要把包重装到全局直接在项目终端里安装即可。11. 最佳实践与使用建议环境配置完成以后建议从第一天就养成几个好习惯。11.1 项目目录和虚拟环境分开管理建议按下面这个结构管理本地代码D:\PythonProjects\ ├── helloworld\ # 单独项目 │ ├── venv\ # 项目虚拟环境 │ ├── main.py │ └── requirements.txt ├──>pip freeze requirements.txt把当前依赖导出到文件换电脑后只需要执行pip install -r requirements.txt就能复现环境。11.2 不要让包管理器到处乱装这里提醒一句网上搜到“PyCharm 破解版”“激活码永久使用”的资源不要下载也不要运行。破解版通常会被二次打包可能植入挖矿或木马。PyCharm 社区版完全免费功能足够支撑入门到中级的开发学习。如果以后需要用专业版直接在 JetBrains 官网购买或者申请学生授权不要尝试非法激活渠道。11.3 先跑通最小示例再逐步扩展不要一开始就写完整爬虫或数据分析程序。新环境建议按以下顺序验证print(Hello)验证基础运行pip install pandas验证包安装写 5 行 pandas 读取 CSV 的代码验证真实业务路径。每一步都确认通过再进入下一步出问题时定位范围小不会把环境问题和方法问题混在一起。11.4 定期更新 Python 和相关工具Python 官方每半年会发布一个新版本但建议不要追新。对于学习阶段使用当前稳定版本即可。PyCharm 可以打开右下角通知栏的更新提示社区版升级免费升级不会影响项目代码。12. 总结与下一步到这里你已经完成了一套可用的 Python 开发环境搭建Python 解释器安装完成、PyCharm 社区版安装完成、项目解释器配置正确、中文界面切换完成、第一个Hello Python程序运行成功、pandas 第三方库安装也验证通过。下一步可以按这个顺序继续先练习 Python 基础语法变量、条件判断、循环、函数、列表和字典再跑一个实际小项目比如用 Python 读取 Excel 或 CSV 文件做简单统计遇到依赖问题就记住一条命令pip install 包名遇到环境问题就去检查解释器路径和python --version把requirements.txt的依赖导出和恢复流程练熟后面写稍微复杂一点项目时会很省事。如果你是照着网上零散教程装了一半、报错卡住的情况建议直接从第 4 章重新装一遍。Python 环境配置完成后后续写代码出错的概率会一下子下降很多精力能留在语言本身的学习上。
新手学 Python头两个小时大概率不是在写代码而是在跟“环境配置”较劲。Python 官网下载太慢、装完提示python 不是内部或外部命令、PyCharm 下载了打不开、代码能写但跑不起来……这些问题几乎每个初学者都会遇到。这一篇就把 2026 年版 Python 和 PyCharm 的下载、安装、配置、验证、跑通第一个程序完整走一遍。全程按零基础视角写不预设你会用命令行也不预设你懂什么编程术语。文章里会用大量表格、步骤和排查清单跟着操作基本不会卡住。1. 核心能力速览这篇教程不是教你背命令而是带你完整走一遍 Python 开发环境从零到能跑的流程。下面先看一下整篇内容覆盖的关键模块。模块说明Python 版本选择2026 年建议选 3.11 以上的稳定版本支持 Win / macOS / Linux安装方式官网下载安装包勾选Add Python to PATH避免手动配环境变量验证方式命令行执行python --version和pip --versionPyCharm 版本新手建议用 Community 社区版免费、可商用、无激活门槛配置解释器在 PyCharm 里选择已安装的 Python 3.x 作为项目解释器中文界面通过 PyCharm 插件Chinese Language Pack切换中文包管理使用pip install安装 pandas / requests / numpy 等常用库常见报错python 不是内部命令、pip 不是内部命令、解释器缺失、源下载慢看完这篇你能独立完成Python 安装、PyCharm 安装、建项目、写第一段 Python 代码、安装第三方库并且知道最常见的报错怎么解决。2. 这篇教程适合谁读先明确一件事这个教程面向的是零基础 Python 入门用户不是给老手看的进阶指南。适合以下三类读者刚决定学 Python还没装过任何开发环境之前按网上教程装过但运行python --version报错环境变量没配好准备用 PyCharm 写 Python 脚本、做数据分析、写爬虫或者练算法题需要一套干净可用的开发环境。如果你已经熟悉命令行、会装 Anaconda、也能独立配置解释器那这篇内容对你来说偏基础可以直接跳到第 9 章看 pip 换源和常见报错。这里要强调的是Python 只是解释器PyCharm 只是编辑器两者是两套独立的软件。很多人混着下载最后发现 PyCharm 能打开但解释器没配置一运行就报No Python interpreter configured。下面第 4 到第 8 章就是围绕这条主线展开的。另外提醒一个比较实际的问题网上搜“PyCharm 激活码”“PyCharm 永久激活”出来的内容很多涉及破解工具这类渠道既不稳定也不安全轻则激活失败、软件被锁重则下到捆绑木马。PyCharm 社区版本身完全免费官方长期维护所有功能对新人完全够用不建议在入门阶段碰任何破解和激活码渠道。3. 安装前的准备与版本选择安装之前先把版本和来源弄清楚这一步能省掉后面很多麻烦。3.1 Python 版本怎么选打开 Python 官网python.org下载页面通常并列着 Python 3.13、3.12、3.11 等版本。2026 年推荐的判断标准是选 3.11 或更新版本的稳定发布版不要选 rc 版、beta 版这类预览版本安装包按系统区分Windows 选Windows installer (64-bit)macOS 选macOS 64-bit universal2 installerLinux 多半用系统包管理器安装不要贪图最新。如果学习资料用的版本是 3.9 或 3.10你装 3.12 也完全兼容绝大多数 Python 基础语法和常用库不受影响。3.2 PyCharm 两个版本怎么选PyCharm 官网jetbrains.com/pycharm提供两个版本版本价格定位适合人群Community 社区版免费Python 基础开发、调试、测试新手、学习、轻度开发Professional 专业版收费/试用Web 框架、数据库、远程开发职业开发、全栈开发新人安装 Community 版就够了社区版支持 Python 开发最核心的代码补全、调试、运行、Git 集成学习阶段不需要专业版功能。Professional 版本有 30 天免费试用试用结束后要付费订阅这个过程完全走官方渠道不要去搜破解或非法激活码。3.3 安装前检查清单检查项说明系统版本Windows 10/11、macOS 12建议提前更新系统补丁磁盘空间Python 安装包约 30MBPyCharm 约 600MB预留 5GB 以上更稳妥网络环境官网下载一般较慢必要时可换镜像源下载旧版本残留如果之前装过 Python建议先卸载干净再装新版管理员权限Windows 安装 PyCharm 时如果是为当前用户安装一般不需要管理员权限4. Python 下载与安装4.1 官网下载步骤访问 Python 官网python.org把鼠标放在顶部导航栏的Downloads系统会自动识别你当前的操作系统直接点击下载按钮即可。需要手动选版本的话进入Downloads Windows或Downloads macOS页面找到对应版本的安装包。Windows 用户下载时需要选择Windows installer (64-bit)。如果你的电脑是老式 32 位系统选 32-bit 版本但 2026 年的 Windows 机器基本都是 64 位系统了。4.2 Windows 安装关键步骤双击运行下载好的.exe文件安装界面出来之后先做两件事底部勾选Add python.exe to PATH点击Install Now进入默认安装流程。Add Python to PATH这个选项是新手最容易漏掉的一步。如果安装时没勾后面在命令行敲python会出现python 不是内部或外部命令需要手动配环境变量非常麻烦。漏掉也没关系第 10 章会给出补救方案。安装过程持续一到三分钟最后看到Setup was successful表示安装完成。macOS 用户安装.pkg文件后Python 会默认安装到系统目录通常不需要手动配置 PATH但建议在终端里验证一下。Linux 用户使用 apt、yum、dnf 等包管理器安装命令示例# Ubuntu/Debian 系 sudo apt update sudo apt install python3 python3-pip # CentOS/RHEL 系 sudo yum install python3 python3-pip5. 验证 Python 环境是否安装成功5.1 命令行验证Windows 按Win R输入cmd回车打开命令提示符输入以下命令python --version如果输出类似Python 3.12.x说明安装成功。再输入pip --version如果输出类似pip 24.x from C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\site-packages\pip (python 3.12)说明包管理工具也可用。macOS 打开终端输入python3 --version pip3 --version注意 macOS 上默认命令可能是python3而不是python这是因为 macOS 本身自带了旧版 Python 环境使用python3可以避免和系统自带的版本冲突。5.2 遇到报错怎么判断命令可能的报错含义python --version不是内部或外部命令环境变量未配置python --version弹出 Windows 商店界面系统进入了应用执行别名pip --version不是内部或外部命令pip 未加入 PATHpython --version报错信息很长提示 msvcp 缺失系统缺少 VC 运行库这些报错第 10 章会逐个给出排查方法不要现在就慌。最常见的原因就是环境变量没有配置好配好之后基本能解决 90% 的问题。6. PyCharm 下载与安装6.1 官网下载访问 PyCharm 官网jetbrains.com/pycharm点击页面上的Download按钮。版本选择页面会列出 Community 和 Professional 两个选项选择 Community 社区版点击下载适用于你系统的安装包。Windows 用户下载.exe安装包macOS 用户下载.dmg文件。6.2 Windows 安装步骤双击安装包第一页点击Next选择安装路径建议保持默认路径不要装在中文目录下否则某些第三方工具和插件可能会因为中文路径出现兼容性问题。接下来这一步有几个安装选项选项建议创建桌面快捷方式建议勾选方便启动添加Open Folder as Project到上下文菜单可选不影响使用添加 bin 目录到 PATH不推荐勾选PyCharm 不需要加入 PATH关联.py文件可选新手建议勾选双击.py文件可以直接用 PyCharm 打开点击Next选择开始菜单文件夹点击Install等待安装完成最后勾选Run PyCharm并点击Finish启动软件。macOS 用户把PyCharm图标拖入Applications文件夹即可完成安装。首次打开如果系统提示“来自身份不明的开发者”需要在系统设置 隐私与安全性中点击允许这是 macOS 对新安装软件的正常拦截不是软件问题。6.3 首次启动设置第一次打开 PyCharm 会进入初始设置页面选择主题风格喜欢深色选Darcula喜欢浅色选IntelliJ Light组件可以全部不安装直接点击Start Using PyCharm如果之前装过旧版 PyCharm会询问是否导入旧设置新手选Do not import settings即可。7. PyCharm 配置 Python 解释器PyCharm 本身不包含 Python它只是编辑器必须告诉它“你项目里的代码用哪个 Python 解释器运行”。这一步新手经常忽略导致运行时报错。7.1 新建项目打开 PyCharm 首页点击New Project进入项目创建界面。你需要关注这几个字段字段填写内容Location项目存放路径建议建一个英文目录例如D:\PythonProjects\helloLanguagePythonInterpreter type选择Custom Environment或Existing指向你已安装的 PythonInterpreter 路径选择 Python 安装目录下的python.exeWindows或python3macOS/Linux如果你在Interpreter type里选择VirtualenvPyCharm 会基于你指定的 Python 给当前项目创建一个独立的虚拟环境这是比较推荐的默认方式不同项目的依赖包不会被互相污染。Windows 默认 Python 安装在C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\python.exemacOS 通常安装位置/usr/local/bin/python3选择好解释器之后点击CreatePyCharm 会创建项目结构和虚拟环境底部的进度条是Creating virtual environment等待几秒即可进入主界面。7.2 配置中文界面插件PyCharm 默认英文界面英文不好也不用担心JetBrains 官方提供了中文语言包插件完全免费。进入 PyCharm 主界面后点击菜单栏File Settings左侧找到Plugins在Marketplace市场搜索框中输入Chinese Language Pack找到由 JetBrains 发布的插件点击Install安装。安装完成后点击Restart IDEPyCharm 重启之后菜单和界面就会变成简体中文。如果没有搜索到中文插件检查一下 PyCharm 版本是否为 2020.1 以上旧版本不支持官方中文语言包。7.3 验证解释器是否配置成功在 PyCharm 顶部菜单选择文件 设置 项目 Python 解释器右侧窗口中应该能看到 Python 3.12 以及它所包含的包列表。如果这里显示的是No Interpreter说明解释器没有正确选择点击齿轮图标选择Add Local Interpreter重新指定 Python 路径。8. 第一个 Python 程序Hello World 测试环境配置完成后马上写第一个程序验证整条链路是否畅通。8.1 新建 Python 文件在 PyCharm 左侧项目目录右键选择新建 Python 文件输入文件名helloPyCharm 会自动创建hello.py文件后缀不用手动输入。在这个文件里输入print(Hello Python) print(PyCharm 环境配置成功)8.2 运行程序点击hello.py文件编辑区右上角的绿色三角按钮或者在编辑区右键选择运行 hello底部会打开运行窗口输出Hello Python PyCharm 环境配置成功 进程已结束退出代码为 0看到退出代码为 0就说明程序正常结束没有报错。如果运行时弹出No Python interpreter configured for the project回到第 7 章重新配置解释器。如果解释器配置正确但运行按钮是灰的检查项目是否创建成功或者文件是否在项目目录内。8.3 用命令行运行实验除了在 PyCharm 里运行命令行运行也需要验证一下。在系统命令行中切换到hello.py所在目录执行python hello.pyWindows 下如果文件在D:\PythonProjects\hello\hello.py先执行d: cd D:\PythonProjects\hello python hello.py这样能确认命令行环境下 Python 也可用以后使用 pip 安装包、运行脚本都不会有问题。9. 常用包安装与 pip 换源Python 真正强大的地方在于第三方库。新手安装量最大的几个库是pandas、numpy、requests、matplotlib。安装方式都是同一个命令。9.1 安装 pandas 示例在 PyCharm 底部打开终端Terminal输入pip install pandas等待下载、安装完成最后出现Successfully installed pandas-x.x.x numpy-x.x.x字样说明安装成功。查看已安装的包pip list这个命令会列出当前环境里所有已安装的包。如果在命令行执行pip报错但在 PyCharm 终端里能正常执行原因通常是 PyCharm 终端自动激活了当前项目的虚拟环境而你系统全局的 Python 环境变量没有配好排查方向要区分开。9.2 国内网络慢就换 pip 源默认情况下 pip 从官方 PyPI 源下载国内网络可能很慢或超时。换用国内镜像源可以显著提升速度。常用的镜像源包括清华源、阿里源、腾讯源。使用方式给镜像源指定参数以清华源为例pip install pandas -i https://pypi.tuna.tsinghua.edu.cn/simple如果希望长期使用可以一次性修改全局配置。Windows 下在C:\Users\你的用户名目录下创建pip文件夹再创建pip.ini文件内容写[global] index-url https://pypi.tuna.tsinghua.edu.cn/simple trusted-host pypi.tuna.tsinghua.edu.cnmacOS 和 Linux 配置路径为~/.pip/pip.conf。9.3 验证第三方库可用写一个小测试代码导入并打印版本import pandas as pd print(pd.__version__)运行后输出类似2.x.x的版本号说明 pandas 安装成功且可以被 Python 导入。新手必须区分pip 安装成功和Python 能导入是两回事——常见坑是用了命令行全局 pip 装包但 PyCharm 项目用的是虚拟环境两个环境互相看不到。解决方式是在 PyCharm 的终端里运行 pip 命令让它装进当前项目环境。10. 常见问题与排查方法新手阶段大部分报错集中在环境变量、解释器选择、pip 源这几个方面。下面把出现频率最高的问题整理成一张排查表。问题现象可能原因排查方式解决方案python 不是内部或外部命令Python 未加入 PATH命令行执行where python查看是否存在重新安装时勾选Add Python to PATH或手动配置环境变量pip 不是内部或外部命令pip 未加入 PATH或 Python 未安装成功命令行执行python -m pip --version执行python -m ensurepip --upgrade或用python -m pip install 包名运行 python 弹出 Windows 商店系统开启了应用执行别名检查设置 应用 应用执行别名关闭 python.exe和 python3.exe 的别名开关PyCharm 里运行时提示无解释器新建项目时没有选择 Python查看文件 设置 项目 Python 解释器点击齿轮图标添加本地解释器选择 python.exepip 安装速度极慢或超时默认访问官方 PyPI 源观察卡在 downloading 阶段使用-i参数切换国内镜像源安装包显示 Successfully installed 但 PyCharm 导入失败安装在全局环境项目用的是虚拟环境PyCharm 终端执行pip list查看包是否存在切换到项目终端再安装或检查解释器路径是否一致PyCharm 中文插件搜索不到版本过低或网络问题查看帮助 关于确认版本更新 PyCharm 到 2020.1 以上并检查网络项目路径含中文导致编译报错系统编码和工具链兼容问题查看报错路径是否包含中文重新建项目路径使用英文目录提示需要安装缺失的节点未安装项目所需的第三方模块查看终端或日志提示的包名在项目终端执行pip install 缺失的包名新装 Python 后 PyCharm 仍指向旧解释器本地存在多个 Python 版本在解释器设置中查看路径在项目设置中重新选择目标 Python 路径10.1 手动配置环境变量补丁如果之前安装时没有勾选Add Python to PATH可以用下面的方式补救。Windows打开此电脑右键选择属性点击高级系统设置点击环境变量在系统变量或用户变量里找到Path点击编辑新建两条记录Python 安装目录以及它的Scripts子目录例如C:\Users\你的用户名\AppData\Local\Programs\Python\Python312 C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\Scripts保存后重新打开命令行执行python --version pip --version只要看到版本号说明环境变量生效。macOS 的 PATH 一般由安装器自动配置如果命令未生效可以在~/.bash_profile或~/.zshrc中追加export PATH/usr/local/bin:$PATH然后执行source ~/.zshrc10.2 区分系统 Python 和虚拟环境 Python这是新手最混乱的一个点。PyCharm 新建项目时默认创建venv虚拟环境虚拟环境里有一个独立的python.exe与系统全局 Python 不共用第三方库。查看当前使用哪个 Python可以在 PyCharm 终端中执行which pythonWindows 平台把which换成where。输出里的路径如果不是全局 Python 路径而是venv目录下的 Python就说明你在虚拟环境中。这个行为是刻意设计的保证项目依赖隔离。遇到包安装到全局但项目导入不了不需要把包重装到全局直接在项目终端里安装即可。11. 最佳实践与使用建议环境配置完成以后建议从第一天就养成几个好习惯。11.1 项目目录和虚拟环境分开管理建议按下面这个结构管理本地代码D:\PythonProjects\ ├── helloworld\ # 单独项目 │ ├── venv\ # 项目虚拟环境 │ ├── main.py │ └── requirements.txt ├──>pip freeze requirements.txt把当前依赖导出到文件换电脑后只需要执行pip install -r requirements.txt就能复现环境。11.2 不要让包管理器到处乱装这里提醒一句网上搜到“PyCharm 破解版”“激活码永久使用”的资源不要下载也不要运行。破解版通常会被二次打包可能植入挖矿或木马。PyCharm 社区版完全免费功能足够支撑入门到中级的开发学习。如果以后需要用专业版直接在 JetBrains 官网购买或者申请学生授权不要尝试非法激活渠道。11.3 先跑通最小示例再逐步扩展不要一开始就写完整爬虫或数据分析程序。新环境建议按以下顺序验证print(Hello)验证基础运行pip install pandas验证包安装写 5 行 pandas 读取 CSV 的代码验证真实业务路径。每一步都确认通过再进入下一步出问题时定位范围小不会把环境问题和方法问题混在一起。11.4 定期更新 Python 和相关工具Python 官方每半年会发布一个新版本但建议不要追新。对于学习阶段使用当前稳定版本即可。PyCharm 可以打开右下角通知栏的更新提示社区版升级免费升级不会影响项目代码。12. 总结与下一步到这里你已经完成了一套可用的 Python 开发环境搭建Python 解释器安装完成、PyCharm 社区版安装完成、项目解释器配置正确、中文界面切换完成、第一个Hello Python程序运行成功、pandas 第三方库安装也验证通过。下一步可以按这个顺序继续先练习 Python 基础语法变量、条件判断、循环、函数、列表和字典再跑一个实际小项目比如用 Python 读取 Excel 或 CSV 文件做简单统计遇到依赖问题就记住一条命令pip install 包名遇到环境问题就去检查解释器路径和python --version把requirements.txt的依赖导出和恢复流程练熟后面写稍微复杂一点项目时会很省事。如果你是照着网上零散教程装了一半、报错卡住的情况建议直接从第 4 章重新装一遍。Python 环境配置完成后后续写代码出错的概率会一下子下降很多精力能留在语言本身的学习上。
