Python安装与PyCharm配置详解：从搭环境到跑通第一个项目

Python 安装和 PyCharm 配置，是每个刚接触编程的人都要过的一道门槛。表面上看就是“去官网下载、点下一步、打开写代码”，但实际执行时经常会出现python命令找不到、PyCharm 提示没有解释器、pip 装不上包、终端输出中文乱码一类的问题。这篇文章按真实落地顺序，把 Python 和 PyCharm 从下载到跑通第一个项目的过程完整拆一遍，讲清楚每一步在干什么、为什么要这样做、出了问题该从哪里查。适合刚入门 Python 的同学，也适合电脑里环境已经比较乱、想重新整理一遍的人。另外先说明一点：PyCharm 社区版本身免费，学习和普通开发完全够用，这篇文章只讲官方安装和正常配置流程，不需要折腾其他额外步骤。

1. Python 安装前，先想清楚这三个问题

很多人一上来就下载安装包，装到一半才发现选错了版本，或者装完发现命令行根本找不到命令。与其这样，不如先花五分钟把三个问题想清楚。

1.1 Python 版本选哪个

直接选 Python 3 的稳定版。官网 Downloads 页面会有一个醒目的下载按钮，一般对应当前最新的稳定版本，直接下载这个就行。

不建议追刚发布的测试版，因为很多第三方库还没有适配好。更不要回头用 Python 2，官方早就停止维护，很多新语法和新库都不支持了。在实际项目里，我见过不少老机器还装着 Python 2，结果新代码一跑就报语法错误，最后还是要统一迁移到 Python 3。

另外要注意选择 64 位版本。现在绝大多数电脑都是 64 位系统，下载 64 位安装包就好。macOS 用户要留意芯片类型，Apple Silicon 和 Intel 芯片有对应的安装包，不确定的话在“关于本机”里看处理器信息。Linux 用户多半系统自带 Python 3，但版本可能偏旧，后面单独说。

1.2 用 PyCharm 还是 VS Code

这是新手问得最多的问题。

PyCharm 是完整 IDE，安装完以后，创建项目、关联解释器、运行调试、查看变量、管理虚拟环境都是一整套流程。对刚入门的人来说，PyCharm 的开箱即用程度更高，不太需要自己折腾插件。

VS Code 更轻量，启动快，但要手动安装 Python 插件、配置解释器、设置运行方式，对第一次接触的人容易卡住。

我的建议是：第一门语言用 PyCharm 起步，先把 Python 语法、调试、报错信息这些基础打牢。等你会写项目了，再按场景换工具完全来得及。工具不是越复杂越好，而是越能让你专注写代码越好。

1.3 Python 安装方式有哪几种

Python 本身的安装方式主要有三种。

不要同时用多种方式装同一个 Python。我遇到过的环境冲突，十有八九是因为电脑里同时存在官网版、Anaconda 自带版和某个软件捆绑安装的旧版本，PATH 里指向哪个完全看运气。后面用where python一查才发现有三分 Python，全乱了。

2. Python 本体安装：核心只有两步，但很多人漏掉第一步

2.1 Windows 安装步骤：不要急着点 Next

Windows 安装 Python 时，最重要的操作出现在第一屏：勾选Add python.exe to PATH。

这一步很多人会忽略，因为它藏在左下角，不显眼。PATH 是系统寻找命令的路径列表。如果你没有把 Python 加进去，命令行输入python时系统不知道去哪里找这个程序，就会提示“不是内部或外部命令”。

所以我的习惯是选择 Customize installation，一路往下，重点关注两个地方：

• Optional Features 里勾上 pip，这是 Python 的包管理工具，后面装第三方库全靠它。
• Advanced Options 里勾上Add Python to environment variables，效果等同于第一步勾选 Add to PATH。

注意：如果你已经漏掉了 PATH，不用慌。重新运行安装包，选择 Modify，把对应选项补勾上即可，不需要卸载重装。

安装过程中如果弹出“允许此应用更改设备”之类的安全提示，正常选择“是”。这一步是系统在确认你有权限安装到 Program Files 目录。

2.2 安装完先做三件事，再打开 PyCharm

装完之后不要急着写代码，先打开命令行验证一下。Windows 用 Win+R，输入 cmd，回车，然后依次执行三条命令。

python --version

正常会输出类似Python 3.12.x的版本号。如果提示找不到命令，说明 PATH 没有生效，先重启命令行再试一遍。重启不行就检查 PATH。

pip --version

这条命令用来确认 pip 是否可用。如果提示找不到，多半是安装时把 Optional Features 里的 pip 取消勾选了。重新运行安装包补装就行。

where python

这条命令会列出当前所有 python.exe 的路径。它能帮你确认命令行实际调用的是哪一个 Python。如果列出来不止一条路径，说明电脑里有多个版本，后面排查环境冲突时非常重要。

2.3 macOS 和 Linux 的安装差异

macOS 上最简单的做法是去官网下载 pkg 安装包，双击安装。习惯用命令行的同学也可以用 Homebrew：

brew install python

Homebrew 装出来的 Python 在/opt/homebrew/bin附近，通常已经自动加入了 PATH。

Linux 下，Ubuntu 系发行版可以这样装：

sudo apt update sudo apt install python3 python3-pip

注意 Linux 里的命令通常是python3，不是python，因为很多发行版保留了 python2 的历史符号链接。验证时用python3 --version。

还有一个容易踩的坑：新版 Ubuntu 对 pip 往系统 Python 里装包限制得很严格，会提示 externally managed environment。这是安全设计，目的是防止你破坏系统环境。解决方法是用虚拟环境，不要强行往系统级 Python 里塞包。

3. PyCharm 安装与首次配置：社区版免费，足够入门

3.1 下载 PyCharm 时选对版本

PyCharm 有两个版本。

社区版对绝大多数 Python 入门场景完全够用，而且免费。如果你不是专门做 Web 开发或者需要连数据库，没必要一开始就考虑专业版。正规的使用方式是：免费版直接下载，专业版如果需要，去官方申请试用或购买授权。官方安装包在 JetBrains 官网的 PyCharm 页面，别从第三方下载站拿，那些捆绑安装的坑太多了。

下载时选择对应系统的安装包：Windows 选 .exe，macOS 选 .dmg，Linux 选 tar.gz 或通过 snap 安装。

3.2 创建第一个项目并关联解释器

PyCharm 安装完成后，第一次启动会引导你选主题和键位方案，按默认就好。真正关键的是 New Project 这一步。

进入 New Project 界面后，需要设置三样东西：

• Location：项目保存路径。建议放在一个专门的开发目录下，不要直接丢桌面。
• Interpreter：这里选择刚才安装的 Python。
• Create a main.py welcome script：勾选后会自动生成一个 main.py 文件。

解释器是新手最容易卡住的地方。PyCharm 只是一个编辑器，它必须知道调用哪个 Python 来执行代码。列表里如果已经检测到 Python，直接选中。列表是空的，就点 Add Interpreter，选择 Add Local Interpreter，再定位到python.exe所在路径。

我为什么一直强调先装 Python 再装 PyCharm？因为顺序反过来，PyCharm 创建项目时找不到解释器，你还得回头补装，很别扭。

3.3 界面设置：中文、字体和常用快捷键

刚装好的 PyCharm 默认英文界面，对不熟悉英文菜单的人来说会有点压力。可以在 Settings > Plugins 里搜索 Chinese Language Pack，这是官方语言包，安装后重启就是中文菜单。

接着建议把字号调大一点。Settings > Editor > Font，字号调到 14 或 16，代码看起来不费眼。主题方面可以选 Darcula 深色，也可以选 Light 浅色，纯看个人习惯。

常用的几个操作先记住：

• 右键代码文件，选 Run，运行当前脚本。
• Ctrl+Shift+F10，快捷键运行当前文件。
• 底部 Terminal 可以直接执行命令行操作。
• 双击 Shift，全局搜索，输入类和文件名都可以。

这些设置不影响功能，但能让你第一次使用时的体验舒服不少。

4. 跑通第一个脚本，再安装第三方包

4.1 最小验证：先写一个 main.py

在 PyCharm 的 main.py 里输入以下内容。

def main(): print("hello python") if __name__ == "__main__": main()

然后右键运行，底部 Run 窗口会输出hello python。

能走到这一步，说明 Python 解释器、PyCharm、项目配置三个环节全部正常。接下来才值得进入正式开发。

我每次搭新环境都会先跑一个最小脚本，因为这一步能最快区分“代码问题”和“环境问题”。如果连 print 都跑不出来，就别急着写更多逻辑。

4.2 用 pip 安装第三方包，并确认安装位置

Python 的第三方包通过 pip 安装。在 PyCharm 底部 Terminal 面板里输入：

pip install requests

装好以后，代码里就可以通过import requests来使用。PyCharm 创建项目时默认会生成一个虚拟环境，所以这里执行 pip，实际是装在当前项目的虚拟环境里，不会影响全局 Python。这个机制后面会细讲。

想确认包到底装在哪，可以用：

pip show requests

输出信息里的 Location 字段就是包所在目录。排查环境问题时，这个字段很有用。比如你明明装了一个包，代码却报 ModuleNotFoundError，很可能是当前解释器和你执行 pip 的环境不是同一个，先去对比 Location。

4.3 下载慢怎么办：换个镜像源

国内网络访问默认的 Python 官方包源，速度有时不太稳定。一个合规且常用的办法是使用国内镜像站，比如清华大学开源软件镜像站、阿里云镜像站。

临时指定镜像源：

pip install pandas -i https://pypi.tuna.tsinghua.edu.cn/simple

也可以永久配置。Windows 在用户目录下找到或新建pip.ini，Linux 和 macOS 对应pip.conf，写入：

[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple

要说明的是，镜像源只是把下载地址换成国内节点，包的内容和官方源一致，合规且安全。缺点是镜像站更新偶尔会有几小时延迟，刚发布的新包如果搜不到，临时切回官方源就行。

5. 新手最容易踩的五个环境坑，按排查顺序整理

5.1 python 提示“不是内部或外部命令”

这是最高频的问题。

现象：在 cmd 里输入python，系统提示不是内部或外部命令。

常见原因有两个：安装时没有勾选 Add to PATH；电脑里有多个 Python，命令行找到的是另一个被卸载过的残留路径。

排查顺序：

1. 关掉当前命令行窗口，重新打开一个，再试python --version。因为 PATH 修改后需要新窗口才生效。
2. 在系统设置里查看环境变量 PATH，确认是否包含 Python 安装目录。
3. 如果 PATH 确实没有，重新运行安装包，选择 Modify，勾选 Add Python to environment variables。

我一般不建议新手手动编辑系统 PATH，一是容易填错路径，二是不小心删掉其他变量会引发新问题。能用安装包自动修复，就走自动修复。

5.2 PyCharm 提示 No interpreter

现象：右下角显示 No interpreter，或者运行按钮是灰色的。

这种情况几乎都是解释器没有关联，不是代码写错了。解决路径：File > Settings > Project 下的 Python Interpreter，点 Add Interpreter，选择 Add Local Interpreter，然后定位到python.exe的真实路径。

定位完成后，看版本号是否正常显示。如果显示无效，说明那个路径下根本没有 python.exe。有同学会手动新建一个名为 Python 的文件夹，然后在里面选中它，这不算解释器。

5.3 pip 安装包失败，先看错误信息

pip 报错看起来五花八门，但归纳起来就三类。

第一类：网络错误。错误信息里出现 timeout、connection、Read timed out 等词。解决方法是换镜像源，同时增加超时时间：

pip install numpy --timeout 120 -i https://pypi.tuna.tsinghua.edu.cn/simple

第二类：权限错误。错误信息里出现 permission denied。Windows 上可以试试加--user，但更好的方式是直接用虚拟环境。Linux 上遇到 externally managed environment，不要强行 sudo 覆盖系统 Python，进入虚拟环境再装。

第三类：依赖或编译错误。常见于一些需要本地编译的包，报错里会出现 error: command 'gcc' failed 或类似内容。解决办法是优先下载包含预编译二进制的版本，很多常用包在 PyPI 上有 wheel 包，不用本地编译。实在编译不过，用 Anaconda 装，它能避免很多底层依赖问题。

5.4 中文乱码

Windows 下控制台输出中文变乱码，本质是编码不一致。Python 3 源码默认 UTF-8 编码，但 Windows 命令行窗口默认可能是 GBK，两者对不上就乱。

在 PyCharm 里跑代码时，一般不会乱码。如果出现乱码，先检查 Settings > Editor > File Encodings，把 Global Encoding、Project Encoding、Default encoding for properties files 都改成 UTF-8。

如果是 cmd 直接运行脚本报乱码，可以考虑在系统设置里打开“Beta 版：使用 Unicode UTF-8 提供全球语言支持”。这是系统级设置，会影响所有软件的编码行为，个别老旧软件可能出现兼容问题，要谨慎开启。多数情况下，用 PyCharm 运行就够了，不用动系统设置。

5.5 目录路径和环境变量混乱

这个问题不报错，但特别耽误时间。

常见场景：项目放在中文目录或带空格的目录里，某些工具处理路径时会出错。解决办法很简单，项目路径用英文，不要带空格，目录层级不要嵌套太深。

另一个场景是多版本冲突。排查方法就是前面说的where python。如果看到多条路径，一条一条确认，把不需要的旧版本卸载干净，再从 PATH 里移除对应条目。

我曾花了大半天整理一台“看起来能跑但老是莫名其妙报错”的环境，最后发现 PATH 里同时存在 Python 3.9、3.11 和一个虚拟环境的残留路径。命令行和 PyCharm 各自调用不同的 Python，导致装的包互相看不到。清理掉重复路径后，问题彻底消失。

6. 进阶：虚拟环境、Anaconda 与周边扩展

6.1 用 venv 给每个项目一个独立环境

虚拟环境的核心价值是隔离。项目 A 需要 numpy 1.x，项目 B 需要 numpy 2.x，如果都装到全局，必然冲突。虚拟环境可以让每个项目有自己的依赖目录。

PyCharm 创建项目时，默认就会生成一个 venv 虚拟环境，对新手来说等于自动帮你做好了隔离。命令行操作也不复杂：

python -m venv myenv

Windows 激活：

myenv\Scripts\activate

Linux 和 macOS 激活：

source myenv/bin/activate

激活成功后，终端提示符前面会出现(myenv)。这时候执行 pip install，包只会进入当前项目环境。想退出，输入deactivate即可。

我建议从一开始就养成“每个项目一个虚拟环境”的习惯。后台发布新项目时最怕的就是看到所有依赖堆在 base 环境里，连哪个版本对应哪个项目都分不清。

6.2 Anaconda 适合什么场景

如果你打算往数据分析、机器学习方向走，Anaconda 或 Miniconda 会更省心。

conda 不仅管理包，还管理 Python 版本。比如某个老项目需要 Python 3.8，你可以创建conda create -n py38 python=3.8这样的独立环境，不用去系统里装多个 Python。

在 PyCharm 里使用 Anaconda 的方法是：Add Interpreter > Add Local Interpreter > Conda，选择 conda 可执行文件和已创建的环境名，即可完成关联。

Anaconda 的缺点是体积大，环境建多了磁盘占用明显。所以如果只是写普通脚本、做 Web 开发，我自己更倾向用 venv，简单直接。

6.3 周边工具按需安装

Python 和 PyCharm 装好以后，很多人还会继续补工具。

Git 是版本管理工具，安装后可以在 PyCharm 里直接查看代码变更、提交历史，对项目开发帮助很大。安装时一路默认，最后选择 Use Git from the command line 之类的选项即可。Git 不需要在 PyCharm 里单独配置，PyCharm 会自动检测系统中的 Git 路径。

AI 辅助方面，新版 PyCharm 支持在插件市场里安装辅助编程插件，也支持接入一些流行的 AI 编程工具。这类工具通常需要按插件页面的说明注册和配置。我的提醒是：入门阶段先别急着装一堆 AI 插件，否则你很难分清一段代码是 AI 生成的还是自己写的，出问题后也不知道怎么调试。等基础扎实了，再用工具提效。

结尾

装 Python 和 PyCharm 这件事，理论上二十分钟能完成，但很多人卡在环境配置上。我个人的建议是：先装 Python，在命令行确认python --version能正常输出；再装 PyCharm，创建项目时关联解释器；然后跑通一个 print 脚本；最后才碰第三方包和虚拟环境。顺序不乱，步骤就稳。

真正长期使用下来，你会发现最值得维护的不是 IDE 本身，而是 Python 环境、项目依赖和目录习惯。把全局 Python 保持干净，每个项目用独立虚拟环境，出现问题先看命令行提示，再查 PyCharm 的项目解释器，大多数环境问题都能在十分钟内定位。踩过几次之后你会发现，很多问题不是工具不好用，而是安装顺序、路径和依赖环境没有处理好。