Python 是解释器PyCharm 是编辑器/IDE。很多新手第一次接触 Python 时最先卡住的问题并不是语法而是下载安装和环境配置装完 Python 后命令行提示“python 不是内部或外部命令”进入 PyCharm 后找不到解释器或者安装了第三方包却在导入时报 ModuleNotFoundError。这篇教程按一条完整流程从下载安装 Python 开始到下载安装 PyCharm、配置正版许可、创建虚拟环境、运行第一个脚本、用 pip 安装第三方包最后补充常见问题的排查路径。读者照着操作一次就能得到一套干净的 Python 开发环境后续写爬虫、数据分析、自动化脚本或 Web 项目时不会卡在第一步。1. 安装前先搞清楚 Python 和 PyCharm 各自负责什么1.1 Python 是解释器PyCharm 是集成开发环境通俗地说Python 是一种编程语言而让代码真正运行起来的程序叫 Python 解释器。你写的.py文件只是文本解释器会逐行读取并把代码转换成计算机能执行的操作。所以安装 Python本质上是安装一个能运行.py文件的解释器。PyCharm 则是一个集成开发环境它把代码编辑、语法高亮、调试、终端、项目文件管理、Git 操作、包管理入口都放在同一个图形界面里。新手不一定必须用 IDE用记事本加命令行也能学习但 PyCharm 能明显减少环境层面的阻力你可以在界面里直接运行脚本看到报错位置还能可视化管理虚拟环境和第三方包。这两个软件的分工很清晰PyCharm 负责“写代码、看结果”Python 解释器负责“真正执行代码”。因此安装顺序应该是先装 Python再装 PyCharm。如果顺序反过来PyCharm 安装好后也必须在设置里手动指定解释器反而多一步。1.2 学习环境和生产环境要分开考虑对于新手来说先在自己的电脑上把“能跑起来”作为目标不需要马上理解所有工程化概念。学习环境通常是指本机安装使用 Python 自带的虚拟环境工具 venv再加上一个免费的社区版 PyCharm足够完成大部分入门练习。生产环境是另一个话题。真实项目需要依赖管理、环境隔离、版本锁定、代码检查、自动化测试、部署脚本、日志和监控。如果从第一天就试图一次性搭建全套生产级环境会感到非常挫败。更合理的策略是先跑通最小开发环境然后逐步加入虚拟环境、requirements.txt、代码格式化、测试等内容。这篇文章主要解决“最小开发环境”但会在后半部分说明长期开发时哪些配置需要提前养成习惯避免以后项目越来越大时回改成本过高。1.3 安装前的系统要求和版本选择安装前应先确认操作系统、磁盘空间和内存。Python 和 PyCharm 对配置要求并不高但 PyCharm 是 Java 桌面应用启动时占内存建议开发机至少有 8GB 内存16GB 会更舒服。项目WindowsmacOSLinux 桌面版推荐系统Windows 10/11 64 位macOS 12 或更新版本Ubuntu 22.04 或更新版本内存8GB 以上8GB 以上8GB 以上磁盘至少留 5GB 可用空间至少留 5GB 可用空间至少留 5GB 可用空间Python 版本以官网当前稳定版为准以官网当前稳定版为准以官网当前稳定版为准PyCharm 版本Community 或 ProfessionalCommunity 或 ProfessionalCommunity 或 Professional版本选择上有几条判断标准Python 大版本建议选择官网默认推荐的稳定版不需要追求最新测试版。学习用 PyCharm Community 足够只有需要 Django、Flask、数据库工具或远程开发时才考虑 Professional。如果电脑已安装多个 Python要记录好各自路径后面配置解释器时指定到具体版本。这里有一个容易混淆的点PyCharm 不会“绑定”某一个 Python 版本你可以在一个项目里使用 Python 3.12在另一个项目里使用 Python 3.13这就是后面要讲的解释器选择。安装阶段先确保本机至少有一个能正常运行的 Python。2. 下载并安装 Python先让命令行能运行 python 和 pip2.1 从 Python 官网下载安装包下载 Python 应优先使用官方网站不要从第三方下载站获取安装包。官网地址是 python.org/downloads。打开后页面会显示当前推荐的稳定版本例如 Python 3.13 或更高版本并提供 Windows、macOS、Linux 的安装入口。2026 年前后的具体版本号会持续更新建议以打开页面时看到的默认稳定版为准。在 Windows 上通常选择 Windows installer (64-bit)。如果电脑是 ARM 架构需要在官网找到对应的 ARM64 安装包。判断方式不复杂在系统信息里查看“系统类型”看到“x64”就下载 64-bit看到“ARM64”则下载 ARM64 版本。macOS 用户下载.pkg安装包后双击按向导安装即可。Linux 用户可以通过系统包管理器安装但发行版仓库里的 Python 版本可能落后于官网稳定版也可以用 pyenv 管理多版本这部分先不展开。下载时要注意文件后缀安装包名称适用系统说明python-3.x.x-amd64.exeWindows 64 位最常见python-3.x.x-arm64.exeWindows ARM64ARM 设备使用python-3.x.x-macos11.pkgmacOS图形安装包Python-3.x.x.tgzLinux 源码需要编译安装注意不要下载名称中包含“源码版”或“Windows embeddable package”的文件。新手通常需要的是标准 Installer而不是内嵌包。2.2 Windows 安装时最关键的三件事Windows 安装界面打开后第一步要勾选最底部的Add python.exe to PATH。如果不勾选安装完成后在终端输入python会提示找不到命令这是新手最常见的第一个坑。第二步是选择安装方式。推荐选择Install Now它会给当前用户安装 Python并自动配置 pip。如果选择 Customize installation可以自定义安装路径但默认选项不需要额外改动。需要说明的是Python 默认安装到用户目录下的 AppData 中路径可能带有用户名。如果用户名包含中文某些老牌命令行工具兼容性会出问题因此更稳妥的做法是自定义安装到例如C:\Python313的简洁路径。具体操作是安装界面里选择 Customize installation在 Optional Features 界面全部默认勾选在 Advanced Options 界面把 Install for all users 和安装路径改好。第三步是在安装完成后打开命令行验证。按Win R输入cmd回车然后执行python --version pip --version如果看到如下输出说明 Python 和 pip 都已正常安装Python 3.13.2 pip 25.0.1 from C:\Python313\Lib\site-packages\pip (python 3.13)这里pip是 Python 自带的包管理工具后面安装第三方库时要用到它。2.3 在 macOS 和 Linux 上验证 PythonmacOS 安装.pkg后打开终端执行同样的命令python3 --version pip3 --versionmacOS 系统自带的 Python 版本通常比较旧官网安装包会安装到/Library/Frameworks/Python.framework并注册python3命令。为了避免和系统旧版混淆macOS 用户最好统一使用python3和pip3命令。Linux 上如果用系统包管理器安装例如 Ubuntu 执行sudo apt update sudo apt install python3 python3-pip安装后也使用python3和pip3检查。因为 Linux 系统中的某些组件依赖 Python 2 或旧版直接执行python可能指向别的文件使用python3更安全。2.4 多版本 Python 并存时的管理思路很多电脑上已经存在多个 Python 版本比如 Python 3.9、3.11、3.13 同时出现。Windows 自带的py启动器可以帮助查看已安装版本py --list输出示例-V:3.13 * C:\Python313\python.exe -V:3.11 C:\Python311\python.exe使用py -3.13可以指定版本运行。PyCharm 配置解释器时也可以直接选择对应版本的python.exe路径。多版本并存本身不是问题问题是 PATH 顺序导致python命令指向了不预期的版本。解决办法是在系统环境变量中把目标 Python 路径和Scripts目录排在前面或者直接使用绝对路径。如果确认某个旧版本不再使用建议卸载干净避免环境变量残留。卸载后要检查PATH中是否还留有旧路径否则命令行可能仍调用到已删除的文件报“找不到 python.exe”。3. 下载安装 PyCharm并用正规许可完成激活和授权3.1 Community 和 Professional 怎么选PyCharm 分两个版本Community Edition社区版和 Professional Edition专业版。社区版免费足够日常 Python 学习、命令行项目、数据分析和自动化脚本专业版是收费软件提供更多 Web 开发和企业级功能。对比项Community 社区版Professional 专业版费用免费付费订阅可试用适用场景Python 基础、脚本、数据科学入门Django、Flask、数据库工具、远程开发Python 解释器支持支持pip 和虚拟环境支持支持数据库工具不支持支持前端/JavaScript 支持基础更强技术支持和更新免费更新订阅期内更新新手的首选是 Community 版。等真正需要做 Web 项目、需要数据库可视化操作或远程开发时再升级 Professional 也不迟。安装社区版后PyCharm 会保留对应许可证状态不需要进行其他激活操作。3.2 从官网下载安装 PyCharmPyCharm 的官方网站是 jetbrains.com/pycharm/download。页面会提供 Community 和 Professional 两个下载入口注意不要下载错版本。Windows 用户选择.exe安装包macOS 选择.dmg或.pkgLinux 选择对应压缩包。Windows 安装时会出现几个选项含义如下创建桌面快捷方式方便日常打开建议勾选。关联.py文件勾选后双击.py会用 PyCharm 打开按需决定。添加到 PATH如果你习惯在终端输入charm命令来启动 PyCharm可以勾选如果只用图形界面可以不勾选。更新 PATH 变量restart needed一般不需要。安装完成后首次启动会进入导入设置界面。如果之前没有 PyCharm 配置选择不导入即可。这个界面不会影响理解后续所有配置都可以在设置里修改。3.3 正规的“激活”路径免费、试用和教育许可PyCharm 的“激活”在本文中指的是合法授权方式不涉及破解工具或第三方激活码。Community 版是免费的不需要激活Professional 版则有以下几种正规路径首次安装 Professional 版后可以免费试用通常为 30 天适合短期评估。购买 JetBrains 官方订阅授权期间可以使用 Professional 全部功能。学生和教师可以申请 JetBrains 教育许可使用教育邮箱在官网完成验证后获得免费使用权限。开源项目维护者可以申请 JetBrains 开源开发许可证但门槛以官方政策为准。不要使用所谓“破解插件”“补丁激活码”“无限重置试用”这些方式。原因有两方面一是这类工具经常捆绑恶意程序可能盗取账号密码或破坏系统文件二是违反 JetBrains 软件许可协议专业版连接公司内部项目时还可能带来法律风险。正确做法是学生就走教育许可预算有限就继续使用 Community 版专业功能确实需要时再购买订阅。如果只依靠搜索引擎找到的“激活码”完成安装通常几天后激活码会失效且 PyCharm 可能提示“Invalid license key”。此时看似是激活问题实际是使用了非正规授权。检查是否从官方渠道获得授权是排查这类问题的第一步。3.4 首次启动配置PyCharm 首次启动会询问界面主题和快捷键方案。主题推荐选择自己看着舒适的颜色快捷键一般保持默认即可。之后进入主界面可能需要等待几分钟让 PyCharm 完成索引。如果使用者希望界面是中文可以在设置中安装官方中文语言包路径是File - Settings - Plugins在 Marketplace 搜索“Chinese Language Pack”安装后重启即可。需要注意中文语言包只是界面翻译不影响代码和报错信息内容。4. 在 PyCharm 里配置解释器、虚拟环境和第一个项目4.1 新建项目并选择 Python 解释器打开 PyCharm 后点击New Project创建项目。这里会看到一个关键配置项Base interpreter。它用于指定当前项目使用哪个 Python 解释器。如果列表里没有自动识别到刚安装的 Python可以点击右侧的Add Interpreter - Add Local Interpreter然后手动选择python.exe。Windows 常见路径是C:\Python313\python.exemacOS 常见路径是/Library/Frameworks/Python.framework/Versions/3.x/bin/python3。选择时还可以直接输入python --version验证版本。这里要理解一个概念PyCharm 本身不包含 Python 解释器它只是调用你安装的 Python。如果 PyCharm 提示“No interpreter”通常是因为没有安装 Python或者安装了但没在项目设置里指定。4.2 虚拟环境 venv 是什么为什么默认推荐在新建项目时PyCharm 默认会创建一个虚拟环境Virtualenv。新手看到项目目录里出现一个.venv文件夹可能会困惑它是什么。简单说虚拟环境是当前项目独立的 Python 运行环境。没有虚拟环境时所有项目都共用同一个全局 Python 和全局第三方包。项目 A 需要 pandas 1.5项目 B 需要 pandas 2.1直接安装会导致冲突。虚拟环境把每个项目的依赖隔离起来A 项目里的包不会影响 B 项目。PyCharm 中默认设置Virtualenv类型使用New environment并在 Location 中指定.venv目录。创建完成后PyCharm 会自动使用该虚拟环境终端也会自动激活。之后在项目里执行的任何pip install都会安装到这个虚拟环境中不会污染全局环境。判断 pip 是否安装在虚拟环境里可以看终端提示符前是否有(.venv)前缀。有前缀说明当前命令行处于虚拟环境中安装的包只会进入本项目。4.3 创建并运行第一个 Python 脚本在 PyCharm 左侧项目区域右键选择New - Python File命名为hello输入以下代码print(Hello, Python) name input(请输入你的名字: ) print(f你好, {name})在编辑区右键选择Run hello下方运行面板会显示Hello, Python然后等待输入名字。控制台输入内容后回车输出完整结果。这里使用input是为了验证 Python 能接收用户输入和后面交互式编程保持一致。运行成功后PyCharm 会在顶部显示解释器路径和当前虚拟环境例如Python 3.13 (.venv)。这个状态说明项目环境配置已经疏通。4.4 配置字体、编码和终端默认字体在部分显示器上可能偏小可以进入File - Settings - Editor - Font调整字号。编码方面在Settings - Editor - File Encodings中把 Global Encoding 和 Project Encoding 都设为 UTF-8避免中文注释在某些环境下乱码。PyCharm 底部自带一个 Terminal它默认使用当前项目的虚拟环境。安装第三方包时不一定要打开外部命令行直接在 PyCharm 的 Terminal 操作更简单因为路径和虚拟环境都已经准备好了。4.5 在项目里添加 requirements.txt一个干净的项目除了代码和虚拟环境外还应该有一个requirements.txt文件用来记录当前项目依赖了哪些第三方包。安装完所有包后在 PyCharm Terminal 里执行pip freeze requirements.txt生成出的文件内容类似pandas2.2.3 requests2.32.3以后换到新电脑或新环境执行pip install -r requirements.txt就能一键安装项目所需的所有依赖。这一步虽然现在用不上但它是从“能运行”走向“可复现”的重要习惯。5. 用 pip 安装第三方包在项目里使用 pandas 等常用库5.1 pip 的角色和工作位置pip 是 Python 自带的包管理工具负责从 PyPIPython Package Index下载并安装第三方库。你不需要单独下载 pandas、requests 等库的安装包只需要在终端执行pip install。在 PyCharm 项目中安装第三方包的位置取决于当前终端是否处于虚拟环境。正确做法是打开 PyCharm 的 Terminal确认提示符前有(.venv)前缀然后执行安装命令。这样包会装进当前项目的虚拟环境不会影响全局 Python。5.2 安装 pandas 并验证以数据分析常用的 pandas 为例在 Terminal 中执行pip install pandas安装成功后你可以用 Python 命令验证python -c import pandas; print(pandas.__version__)如果输出类似2.2.3说明 pandas 已经可用。在 PyCharm 中新建脚本也可以直接import pandas运行后不报错即说明解释器和包路径都正确。安装过程中如果出现超时或 SSL 错误可以尝试使用国内镜像源。例如用清华源临时安装pip install pandas -i https://pypi.tuna.tsinghua.edu.cn/simple也可以把镜像源写入 pip 配置使以后默认使用镜像。但要注意镜像源应选择官方认可或大型机构维护的站点不要使用来路不明的第三方源否则可能出现包被篡改或依赖缺失的问题。5.3 pip 常用命令速查命令作用示例pip install 包名安装包pip install requestspip install 包名版本号安装指定版本pip install requests2.32.3pip uninstall 包名卸载包pip uninstall requestspip list查看已安装包pip listpip show 包名查看指定包信息pip show pandaspip freeze requirements.txt导出依赖pip freeze requirements.txtpip install -r requirements.txt安装依赖清单pip install -r requirements.txt新手使用 pip 时常见的错误是提示No module named pip。可能原因安装 Python 时取消了 pip 组件或者Scripts目录不在 PATH 中。解决办法是重新运行 Python 安装包选择 Modify在 Optional Features 中勾选 pip。5.4 安装包后仍然报 ModuleNotFoundError以import requests报ModuleNotFoundError为例排查顺序是确认包安装成功执行pip show requests看有没有输出。确认安装位置执行pip --version看 pip 指向哪个 Python。如果 pip 指向全局 Python而 PyCharm 项目使用的是虚拟环境包当然导入失败。确认当前运行脚本的解释器PyCharm 右下角或右上角会显示解释器名称应保证是项目对应的虚拟环境。这个问题的根因通常是“安装到哪里”和“运行时去哪里找模块”不一致。用 PyCharm 的 Terminal 安装包通常能避免大多数路径错位问题。6. 新手最容易踩的坑和排查链路6.1 “python 不是内部或外部命令”现象在命令行输入python时提示找不到命令。可能原因安装 Python 时没有勾选Add python.exe to PATH或者 PATH 配置错误。检查方式在命令行执行where python如果没有任何输出就说明当前终端找不到 Python 解释器。解决方式重新运行 Python 安装包选择 Modify勾选Add python.exe to PATH完成修改后重新打开命令行。也可以手动在系统环境变量的Path中加入 Python 安装目录和Scripts子目录例如C:\Python313和C:\Python313\Scripts。6.2 “PyCharm 找不到解释器”现象新建项目后PyCharm 提示No interpreter或解释器列表为空。检查方式先到命令行执行python --version确认本机已安装 Python。如果命令行可用说明解释器存在只需要在 PyCharm 里手动添加。解决方式File - Settings - Project - Python Interpreter - Add Interpreter - Add Local Interpreter选择 System Interpreter 或 Existing Environment再指定python.exe路径。添加完成后脚本就能运行。6.3 “pip 安装超时或 SSL 错误”现象执行pip install时长时间卡住或提示ReadTimeoutError、SSLError。可能原因网络到 PyPI 的连接不稳定或所在网络环境屏蔽了 PyPI 访问。解决方式临时使用国内镜像源例如清华 PyPI 镜像。也可以配置全局 pip 源但不要把镜像源配置得过于老旧的版本。pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple配置后再执行pip install通常会快很多。如果仍然失败检查 DNS、代理或公司网络策略。6.4 项目里多个 Python 版本导致解释器混乱现象在项目里安装了 pandas但运行时仍提示找不到 pandas。检查方式在 PyCharm 终端执行python -c import sys; print(sys.executable)这一行会输出当前 Python 解释器的绝对路径看它是不是 PyCharm 项目配置的路径。解决方式统一使用虚拟环境不要在全局环境里安装项目依赖。如果已经装错位置先卸载全局包再在 PyCharm Terminal 的虚拟环境中重新安装。多版本并存时更要用 venv 隔离。6.5 使用非正规激活工具后的异常现象PyCharm 安装后提示许可证无效或启动时报错、弹窗、无法正常打开也可能进程被杀毒软件拦截。原因使用了注册机、补丁或临时脚本修改许可证文件这类工具会篡改软件安装目录和配置文件导致 PyCharm 的许可证校验失败甚至导致运行环境损坏。解决方式卸载 PyCharm删除残留的配置文件然后到官网重新下载安装。许可方面使用社区版、官方试用、订阅或教育授权。如果本机出现过由恶意激活工具导致的安全告警还应该运行杀毒软件全盘扫描。6.6 杀毒软件拦截安装或运行现象安装 PyCharm 时提示“找不到文件”或“拒绝访问”启动时 PyCharm 崩溃。可能原因Windows Defender 或第三方安全软件把 PyCharm 的安装缓存或临时文件误判为风险程序。解决方式从官网重新下载安装包安装时不需要关闭杀毒软件但可以检查安全软件的隔离区恢复误删文件并加入信任列表。正规的 PyCharm 安装包来自 JetBrains 官方通常不会被误判如果频繁出现拦截应优先怀疑下载文件来源是否可靠。排查原则先检查输入和错误现象再检查路径、版本、权限和网络最后看日志和官方文档。不要一遇到问题就卸载重装那样往往浪费时间且无法找到真正根因。7. 安装完成后的可用配置清单和下一步学习建议7.1 长期开发前的环境检查清单以下清单可以保存下来每次换新电脑或重新配置环境时逐项确认检查项检查方式达标标准Python 可用python --version显示目标版本号pip 可用pip --version显示 pip 版本和 Python 路径PyCharm 已安装能从桌面启动正常进入项目界面项目解释器正确PyCharm 右下角显示项目虚拟环境路径虚拟环境已激活终端提示符有(.venv)前缀第三方包可导入python -c import pandas不报 ModuleNotFoundError依赖已记录查看 requirements.txt包含当前项目依赖7.2 一个干净的项目结构示例基础项目目录可以按下面方式组织my_project/ ├── .venv/ # 虚拟环境自动生成 ├── src/ # 源代码目录 │ └── main.py # 入口脚本 ├── tests/ # 测试代码目录 │ └── test_main.py ├── requirements.txt # 依赖清单 └── README.md # 项目说明PyCharm 新建项目默认不创建src和tests目录但手动创建并不复杂。学习阶段可以先用一个脚本文件代替等项目变大后再拆分目录。7.3 从安装走向学习路线的建议完成安装后下一步不是急着学框架而是先巩固基础熟悉 Python 语法变量、条件、循环、函数、列表、字典。熟悉文件操作和异常处理用open读写文件用try except处理错误。熟悉 pip 和虚拟环境每做一个项目都新建一个 venv。选择一个方向深入数据分析学 pandas爬虫学 requestsWeb 开发学 Flask。学会阅读官方文档官方文档通常比二手教程更准确。7.4 一个可以马上练习的小程序在 PyCharm 里新建calc.py输入以下代码def add(a, b): return a b num1 float(input(请输入第一个数: )) num2 float(input(请输入第二个数: )) print(f结果是: {add(num1, num2)})输入两个数字程序会计算它们的和。这个小例子覆盖了输入输出、函数定义、类型转换和 f-string 四个基础知识点也是验证开发环境是否完全可用的最好方式。环境搭建没有一次性完成的标准答案随着使用场景变化可能需要调整 Python 版本、切换解释器、更换 IDE 配置。但只要能理解“Python 负责运行PyCharm 负责编辑环境venv 负责隔离依赖pip 负责安装包”这四条主线后续遇到任何环境问题都能找到排查方向。第一次配置不着急追求完美先把最基本的流程跑通再在日常开发中逐步优化。