news 2026/9/2 19:09:27

Python开发环境搭建指南：从零配置PyCharm到运行第一个程序

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Python开发环境搭建指南：从零配置PyCharm到运行第一个程序

这次我们来看 Python 和 PyCharm 的安装配置。对于刚入门编程的新手来说，环境搭建是第一个拦路虎，很多人卡在下载、安装、配置环境变量和第一个程序上。这篇文章的目标就是帮你无痛跨过这个门槛，提供一个从零开始、一步不落的完整指南。

我们将覆盖 Python 解释器的下载安装、环境变量配置验证、PyCharm 集成开发环境的安装与基本设置，并最终运行你的第一个 Python 程序。整个过程会详细到每一个点击和每一步验证，确保即使是零基础的小白也能一次成功。如果你关心的是如何在 Windows 系统上快速搭建一个可用的 Python 开发环境，那么这篇文章可以直接跟着操作。

1. 核心能力速览：Python 与 PyCharm 组合

在深入步骤之前，我们先快速了解这套组合能为你提供什么，以及你需要准备什么。

能力项说明
核心组件Python 解释器（运行代码） + PyCharm IDE（编写、调试、管理代码）
适用平台本文以Windows为例，macOS 和 Linux 思路类似，具体路径不同
硬件门槛极低。现代电脑均可，无独立显卡要求。主要占用磁盘空间。
下载方式均从官方网站下载，确保安全且为最新稳定版。
关键动作1. 安装 Python 并配置环境变量
2. 安装 PyCharm社区版（免费）
3. 在 PyCharm 中创建项目并运行代码
最终成果获得一个本地、隔离、可运行的 Python 开发环境，能够执行脚本、安装第三方库、进行基础开发。
适合场景编程初学者入门、数据分析、自动化脚本、Web 后端学习、机器学习环境基础搭建等。

2. 适用场景与使用边界

这套环境是绝大多数 Python 学习者和开发者的起点。

  • 适合谁？

    • 零基础编程小白，想学习 Python。
    • 需要本地运行 Python 脚本进行数据分析、办公自动化的职场人士。
    • 学生，用于完成课程作业或项目。
    • 开发者，需要一个新的、干净的 Python 环境测试代码。

  • 能解决什么问题？

    1. 环境隔离：通过 PyCharm 的项目管理，可以为不同项目创建独立的虚拟环境，避免库版本冲突。
    2. 高效编码：PyCharm 提供代码补全、语法高亮、错误提示、调试器等强大功能，极大提升开发效率。
    3. 一站式管理：从代码编写、运行、调试到包管理，都在一个工具内完成。

  • 不适合什么场景？

    • 追求极简、仅通过命令行或文本编辑器（如 VSCode）写脚本的资深用户。
    • 需要特定旧版本 Python 或复杂交叉编译环境的场景（但本方法搭建的基础环境仍可作为起点）。

  • 使用边界提醒：

    • 请始终从 Python 和 JetBrains 官网下载软件，避免使用来历不明的安装包，以防安全风险。
    • 安装第三方库时，注意其开源协议和用途，用于商业项目需谨慎评估。

3. 环境准备与前置条件

开始之前，请确认你的电脑满足以下条件：

  1. 操作系统：Windows 10 或 Windows 11。本文演示基于 Win11，Win10 步骤几乎一致。
  2. 用户权限：确保你有管理员（Administrator）权限，以便顺利安装软件和配置系统环境变量。
  3. 磁盘空间：预留至少 2-3 GB 的可用空间，用于安装 Python、PyCharm 以及后续的项目和库。
  4. 网络连接：需要稳定的网络以下载安装包和后续的 PyCharm 插件或 Python 包。

关键检查点：

  • 打开“此电脑”，查看 C 盘或你准备安装的盘符是否有足够空间。
  • 在开始菜单搜索“cmd”，右键点击“命令提示符”，选择“以管理员身份运行”。如果能成功打开，说明具备管理员权限。

4. 第一步：Python 解释器下载与安装

这是最核心的一步，Python 是引擎，必须先安装好。

4.1 下载 Python 安装包

  1. 打开浏览器，访问 Python 官方网站：https://www.python.org。
  2. 将鼠标悬停在导航栏的 “Downloads” 上，对于 Windows 用户，通常会直接显示一个大的黄色按钮，如 “Download Python 3.12.x”。强烈建议不要直接点击这个按钮，因为它可能下载的是 32 位版本。
  3. 点击进入 “Downloads” -> “Windows”。
  4. 在 “Stable Releases” 部分，找到最新的稳定版（如 Python 3.12.x）。根据你的系统选择安装包：
    • 64 位系统：选择Windows installer (64-bit)。
    • 32 位系统：选择Windows installer (32-bit)。（如何查看系统类型？右键“此电脑”->“属性”，查看“系统类型”）。
    • 建议：优先下载Windows installer (64-bit)，除非你的电脑是非常老的 32 位系统。

4.2 安装 Python 并配置环境变量

下载完成后，双击运行安装包。

安装过程有一个至关重要的选项必须勾选：

  1. 在安装向导的第一个界面，务必勾选最下方的Add python.exe to PATH。这个操作会自动将 Python 添加到系统环境变量，让你能在任何命令行窗口直接使用python命令。这是避免后续无数麻烦的关键。(注：此处应为勾选 Add python.exe to PATH 的截图示意)
  2. 然后选择安装方式：
    • 推荐给新手：直接点击 “Install Now”，它会使用默认路径（通常是C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\）进行安装。
    • 自定义安装：点击 “Customize installation” 可以修改安装路径（例如安装到D:\Python312），但请确保路径不含中文和空格。在后续的 “Advanced Options” 中，同样要确保Add Python to environment variables被勾选。
  3. 点击 “Install”，等待安装完成。
  4. 安装完成后，显示 “Setup was successful”。不要急着关闭！请点击下方可能出现的 “Disable path length limit” 选项（如果存在），这可以解除 Windows 对路径长度的限制，对开发有益。然后点击 “Close”。

4.3 验证 Python 安装是否成功

这是检验上一步是否成功的关键操作。

  1. 打开命令提示符：按Win + R键，输入cmd，回车。
  2. 输入验证命令：在打开的黑色窗口中，输入以下命令并回车：
    python --version
    或者
    python -V
  3. 查看结果：
    • 成功情况：会显示Python 3.12.x（你的具体版本号）。这说明 Python 已安装且环境变量配置正确。
    • 失败情况：如果显示‘python’ 不是内部或外部命令，也不是可运行的程序或批处理文件。，说明环境变量未配置成功。你需要手动添加环境变量，具体步骤可搜索“Windows 手动添加 Python 到 PATH”。
  4. 进入 Python 交互模式（可选验证）：在命令行中输入python并回车。你会看到以>>>开头的提示符，这表示你已经进入了 Python 的交互式命令行。输入print(“Hello, World!”)回车，会看到输出。输入exit()或按Ctrl+Z再回车可以退出。

至此，Python 解释器已准备就绪。

5. 第二步：PyCharm IDE 下载与安装

PyCharm 是 JetBrains 公司出品的强大 Python IDE，社区版免费且功能足够初学者使用。

5.1 下载 PyCharm 社区版

  1. 打开浏览器，访问 JetBrains 官网 PyCharm 页面：https://www.jetbrains.com/pycharm/download/。
  2. 在 “Community” 版本下，点击 “Download” 按钮。这是完全免费的版本，支持基础的 Python 开发功能。
  3. 等待安装包（.exe文件）下载完成。

5.2 安装 PyCharm

  1. 双击运行下载的安装包。
  2. 选择安装路径：建议修改到一个你容易找到的目录，例如D:\Program Files\JetBrains\PyCharm Community Edition。同样，路径不要有中文和空格。
  3. 安装选项配置（非常重要）：
    • Create Desktop Shortcut：创建桌面快捷方式，建议勾选（64-bit launcher）。
    • Update PATH variable (restart needed)：建议勾选。这将把 PyCharm 的启动命令添加到系统 PATH，以后可以在命令行直接用pycharm命令打开项目。
    • Update Context Menu：添加到右键菜单，可选。
    • Create Associations：关联.py文件，建议勾选，以后双击.py文件默认用 PyCharm 打开。
    • Download and install JRE x86 by JetBrains：PyCharm 本身需要 Java 运行环境，勾选让它自动安装即可。
  4. 点击 “Next” 或 “Install”，等待安装完成。
  5. 安装完成后，勾选Run PyCharm Community Edition，点击 “Finish” 启动 PyCharm。

5.3 首次运行与基本配置

  1. 接受用户协议：首次启动，会提示是否导入设置，选择 “Do not import settings”。
  2. 主题选择：选择你喜欢的 UI 主题（Darcula 深色 或 Light 浅色），点击 “Next: Featured plugins” 或 “Skip Remaining and Set Defaults” 跳过插件安装（后续可随时安装）。
  3. 激活与登录：社区版无需激活码，可以直接开始使用。如果你有 JetBrains 账号可以登录，用于同步设置，非必须。

6. 第三步：在 PyCharm 中创建第一个 Python 项目

现在，我们将 Python 和 PyCharm 结合起来，创建并运行你的第一个程序。

6.1 创建新项目

  1. 在 PyCharm 欢迎界面，点击 “New Project”。
  2. 配置项目：
    • Location：选择或输入你的项目存放路径，例如D:\MyPythonProjects\first_demo。
    • Project Type：确保是 “Pure Python”。
    • Python Interpreter：这是核心配置！
      • New environment using：默认是Virtualenv。这是最佳实践，它会为这个项目创建一个独立的虚拟环境，隔离不同项目的依赖。保持默认即可。
      • Location：虚拟环境会创建在你项目目录下的venv文件夹中。
      • Base interpreter：点击下拉框或后面的 “…” 按钮，系统应该会自动检测到你刚才安装的 Python（如Python 3.12 (C:\...\python.exe)）。请务必确认这里指向的是正确的 Python 解释器。如果没找到，可以手动定位到你的 Python 安装路径下的python.exe。
  3. 取消勾选 “Create a main.py welcome script”（我们手动创建）。点击 “Create”。

6.2 创建并运行 Python 文件

  1. 在 PyCharm 左侧的项目文件树中，右键点击你的项目名first_demo->New->Python File。
  2. 输入文件名，例如hello，回车。PyCharm 会自动创建hello.py文件。
  3. 在右侧打开的代码编辑区，输入你的第一行代码：
    print("Hello, PyCharm and Python World!")
  4. 运行代码：有多种方式：
    • 方式一（推荐）：右键点击代码编辑区的任意位置，选择Run ‘hello’。
    • 方式二：点击代码行号右侧的绿色小三角箭头。
    • 方式三：使用快捷键Shift + F10。
  5. 查看结果：PyCharm 底部的Run工具窗口会自动打开，并显示运行结果：
    C:\Users\...\venv\Scripts\python.exe D:\MyPythonProjects\first_demo\hello.py Hello, PyCharm and Python World! Process finished with exit code 0
    看到Hello, PyCharm and Python World!的输出，并且进程以代码0退出，恭喜你，你的第一个 Python 项目成功运行！

7. 功能测试与效果验证：环境能力检查

安装完成并成功运行“Hello World”只是第一步。下面我们进行几个关键测试，确保环境功能完整。

7.1 测试一：包管理工具 pip 是否可用

Python 的强大离不开海量的第三方库，而pip是安装这些库的工具。

  1. 在 PyCharm 中，打开底部的Terminal标签页。这是一个内置的命令行终端，并且已经激活了当前项目的虚拟环境（你会看到命令行前缀有(venv)字样）。
  2. 输入以下命令，查看 pip 版本并升级它（如果需要）：
    pip --version pip install --upgrade pip
    如果能够正常显示版本号并完成升级，说明 pip 工作正常。

7.2 测试二：安装并使用第三方库

让我们安装一个最常用的库requests（用于网络请求）来测试。

  1. 在刚才的Terminal中，输入：
    pip install requests
    等待安装完成，显示 “Successfully installed requests-...”。
  2. 在hello.py文件中，写入新的代码：
    import requests response = requests.get('https://www.baidu.com') print(f‘请求状态码：{response.status_code}’) print(‘百度首页标题中包含“百度”字样：’， ‘百度’ in response.text)
  3. 再次运行hello.py。如果输出状态码为 200，并且第二行为 True，说明requests库安装成功且能正常使用。

7.3 测试三：验证虚拟环境的隔离性

虚拟环境是 Python 开发的好习惯。让我们验证它确实隔离了。

  1. 在 PyCharm 的Terminal中，输入pip list。你会看到已安装的包列表，其中包含requests。
  2. 打开系统自带的命令提示符（Win+R,cmd），注意它的前面没有(venv)。
  3. 在系统命令行中输入pip list或python -m pip list。你会发现，系统全局环境下的包列表里没有刚才安装的requests。这证明了项目虚拟环境起到了隔离作用。

8. PyCharm 基础配置与效率提升

为了让 PyCharm 更好用，可以进行一些基础配置。

8.1 设置 Python 解释器（全局）

如果你后续想为其他项目更换解释器（例如安装了 Anaconda），可以这样设置：

  1. File->Settings(或Ctrl+Alt+S)。
  2. 找到Project: your_project_name->Python Interpreter。
  3. 点击右上角的齿轮图标，选择Add...，可以添加系统已安装的其他 Python 解释器或 Conda 环境。

8.2 安装实用插件

PyCharm 插件市场有很多增强工具。

  1. File->Settings->Plugins。
  2. 在Marketplace选项卡中搜索：
    • Chinese (Simplified) Language Pack：官方中文语言包。
    • Rainbow Brackets：给括号加上彩虹色，方便匹配。
    • CodeGlance：在编辑器右侧显示代码缩略图。
  3. 找到后点击Install，安装后根据提示重启 PyCharm。

8.3 调整字体和外观

  1. File->Settings->Editor->Font：可以调整代码字体和大小。
  2. File->Settings->Appearance & Behavior->Appearance：可以切换主题，调整整体 UI 字体。

9. 常见问题与排查方法

即使按照教程，也可能遇到问题。下表列出了常见问题及解决方法。

问题现象可能原因排查方式解决方案
命令行输入python提示“不是内部或外部命令”Python 安装时未勾选 “Add to PATH”，或环境变量未生效。1. 检查安装时是否勾选。
2. 在系统属性中检查 PATH 是否包含 Python 安装目录和 Scripts 目录。		1. 重新安装并勾选选项。
2. 手动添加环境变量：将Python安装路径(如C:\Python312) 和Python安装路径\Scripts添加到系统环境变量 PATH 中。
PyCharm 创建项目时找不到 Python 解释器PyCharm 未自动扫描到，或 Python 安装在不常见路径。在创建项目的 “Base interpreter” 处，点击 “…”，手动浏览定位。导航到 Python 安装目录，选择python.exe文件。
运行代码时提示ModuleNotFoundError: No module named ‘xxx’所需的第三方库没有安装。在 PyCharm 的 Terminal 或系统命令行中，尝试pip list查看是否已安装。在激活的虚拟环境（PyCharm Terminal）中，使用pip install xxx安装缺失的库。
pip 安装库速度慢或超时默认源服务器在国外，网络不稳定。尝试用浏览器访问https://pypi.org看是否通畅。更换为国内镜像源。临时使用：pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple。永久配置请搜索“pip 永久换源”。
PyCharm 打开或运行很卡1. 项目文件过多。
2. 内存分配不足。
3. 插件冲突。		检查任务管理器内存和CPU占用。1. 在Settings->Editor->File Types中忽略不需要索引的文件夹（如venv,__pycache__,.idea）。
2. 调整Help->Edit Custom VM Options增加内存（需谨慎）。
3. 禁用不常用的插件。
安装包时提示权限错误在系统目录或无权限目录尝试安装。查看错误信息是否包含 “Permission denied” 或 “access is denied”。1.推荐：在 PyCharm 的 Terminal（已激活 venv）中安装，这是用户目录，有权限。
2. 以管理员身份运行命令提示符，但不推荐全局安装。

10. 最佳实践与使用建议

建立好环境只是开始，遵循一些好习惯能让你的开发之路更顺畅。

  1. 一项目一环境：始终使用 PyCharm 的虚拟环境（Virtualenv）功能。为每个新项目创建独立的venv，这是避免依赖地狱的最佳实践。
  2. 使用requirements.txt：在项目根目录，可以通过pip freeze > requirements.txt命令将当前环境的所有依赖包及版本号导出到一个文件中。其他人拿到你的项目后，只需运行pip install -r requirements.txt即可一键复现环境。
  3. 善用 PyCharm 的调试器：不要只用print调试。在代码行号左侧点击设置断点，然后使用Debug ‘hello’（绿色虫子图标）模式运行。可以逐行执行，查看变量值，是排查复杂 bug 的神器。
  4. 版本控制入门：尽早学习使用 Git。PyCharm 内置了出色的 Git 支持。将代码托管到 GitHub 或 Gitee，不仅是备份，也是学习协作和项目管理的开始。
  5. 定期更新：可以定期检查并更新 Python 和 PyCharm 到稳定版本，以获得性能提升和新功能。但生产环境下的项目，升级前需在测试环境充分验证兼容性。

至此，你已经拥有了一个功能完整、配置正确的 Python 开发环境。这个环境是学习、探索和构建一切 Python 应用的基础。接下来，你可以开始学习 Python 语法、尝试各种有趣的库，或者开始你的第一个小项目了。如果在后续使用中遇到新的问题，记住排查思路：确认环境、检查路径、查看错误日志、善用搜索引擎和官方文档。

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/9/2 19:08:38

Gitblit 1.9.3部署与internal error排查实战指南

简介：Gitblit 1.9.3 压缩包是一款面向 Java 技术栈团队的开源 Git 仓库管理工具，设计简洁直观、易上手，支持独立部署或嵌入 Java Web 应用，可完成仓库的创建、克隆、推送、拉取以及精细的权限访问控制，适合个人开发者与…

作者头像 李华
网站建设 2026/9/2 19:06:33

钢笔彩墨新手避坑指南：从墨水特性到笔纸匹配的完整攻略

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

作者头像 李华
网站建设 2026/9/2 19:04:46

32位FFmpeg 6.0.1编译与实战：老系统视频处理方案

简介：利用 VS2015 在 32 位 Windows 环境下编译 FFmpeg 6.0.1 后打包的资源，面向需要在 Win32 平台做音视频开发、二次封装或功能裁剪的技术人员。下载后可直接获得可用的 DLL、头文件和导入库，经过实测能够正常调用，省去手动编译…

作者头像 李华
网站建设 2026/9/2 19:03:38

雪佛兰Lumina CSV CR8高温赛道工程解析：从整备到数据闭环

雪佛兰Lumina CSV CR8赛车出现在阿联酋赛道，很多人第一反应是“小马拉大车”——普通Lumina是一台偏向日常通勤的量产房车，赛道版CR8却完全是另一套工程体系。看一台赛车不能只看外观贴纸和尾翼，真正要拆解的是整车在高温、高沙尘、高速弯道环…

作者头像 李华
网站建设 2026/9/2 19:03:31

平面变压器设计实战：从高频损耗、EMC到量产的全流程解析

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

作者头像 李华
网站建设 2026/9/2 19:02:36

电赛双车跟随系统实战：STM32 PID控制与传感器融合方案详解

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

作者头像 李华