跳到主要内容
极客日志极客日志
首页博客AI提示词GitHub精选代理工具
搜索
|注册
博客列表
PythonAI

Python 与 PyCharm 环境搭建指南(Windows / macOS)

涵盖 Python 及 PyCharm 在 Windows 和 macOS 上的完整安装流程。重点说明环境变量配置、解释器关联及常见报错处理,帮助开发者快速构建本地开发环境。核心要点包括安装时勾选 PATH、使用纯英文路径、以及解决命令无法识别等问题。

PgDevote发布于 2026/3/23更新于 2026/4/263 浏览
Python 与 PyCharm 环境搭建指南(Windows / macOS)

Python 与 PyCharm 环境搭建指南

Python 在数据分析、人工智能及 Web 开发领域应用广泛,而 PyCharm 作为 JetBrains 推出的集成开发环境(IDE),凭借强大的功能成为许多开发者的首选。本指南以 Windows 10/11 和 macOS Sonoma 为例,介绍如何从官网下载并配置最新版本的 Python 环境与 PyCharm,同时梳理了安装过程中常见的报错及解决方案。

一、Python 安装流程

1. 下载安装包

访问 Python 官网 (https://www.python.org/),建议使用 Chrome 或 Firefox 浏览器。进入 Downloads 页面后,系统通常会自动识别操作系统并推荐对应版本。

  • Windows:直接点击推荐的安装包链接(如 python-3.x.x-amd64.exe)。 文章配图 文章配图 文章配图

  • macOS:选择 macOS 选项,根据芯片类型下载对应安装包(Intel 选 x86_64,M 系列选 arm64)。

注意:当前主流版本已兼容 Windows 11 和 macOS Sonoma,无需额外担心系统兼容性。

2. 执行安装

双击运行安装包,这里以 Windows 为例,macOS 步骤类似。

关键设置: 首次启动安装向导时,务必勾选底部的 "Add Python to PATH"。这一步能自动配置环境变量,避免后续手动设置的麻烦。如果忘记勾选,后面需要手动添加环境变量路径。

建议点击 "Customize installation" 进行自定义安装,而不是使用默认的 "Install Now",这样更容易控制安装位置。

文章配图

自定义选项:

  • Optional Features:保持默认全选,确保 pip、IDLE 等组件被安装。 文章配图
  • Advanced Options:建议修改安装路径为纯英文且不含空格的路径(例如 D:\Python)。同时勾选 "Disable path length limit" 以避免长路径导致的文件操作问题。 文章配图 文章配图
  • 安装完成后点击 "Finish" 关闭窗口。

    3. 验证安装

    打开命令行工具验证环境是否生效。

    • Windows:按 Win + R 输入 cmd。 文章配图

    • macOS:打开终端(Terminal)。

    输入以下命令查看版本:

    python --version
    # macOS 可能需要使用 python3 --version
    

    若输出类似 Python 3.13.0 的版本号,说明安装成功。接着验证 pip:

    pip --version
    # macOS 可能需要使用 pip3 --version
    

    看到 pip 版本号即表示包管理工具正常。

    二、PyCharm 安装与配置

    PyCharm 分为社区版(Community)和专业版(Professional)。社区版免费,适合学习和基础开发;专业版支持 Web 开发和数据库等功能,学生可通过学校邮箱申请免费授权。

    1. 下载安装包

    访问 JetBrains 官网 (https://www.jetbrains.com/pycharm/) 点击 Download。

    • Windows:选择 Community Edition 的 .exe 安装包。
    • macOS:选择 Community Edition 的 .dmg 安装包。

    文章配图

    2. 安装步骤

    双击安装包运行,建议将安装路径修改为非系统盘目录(如 D:\PyCharm),避免占用 C 盘空间。

    文章配图

    必选项:

    • 勾选 "Create Desktop Shortcut" 创建桌面快捷方式(建议选择 64-bit)。 文章配图

    保持开始菜单文件夹默认,点击 Install 等待完成。

    文章配图

    3. 首次启动与解释器关联

    首次启动会提示导入设置,选择 "Do not import settings" 即可。

    文章配图

    配置 Python 解释器:

    1. 点击 "New Project" 创建新项目。
    2. 指定项目保存路径(如 D:\PythonProjects\FirstProject)。
    3. 在 "Python Interpreter" 处点击 "Add Interpreter" → "Existing environment"。
    4. 浏览找到之前安装的 Python 路径(如 D:\Programs\Python313\python.exe),确认 OK。
    5. 勾选 "Create a main.py welcome script",点击 Create。

    验证环境: 在项目中新建 main.py,输入测试代码:

    print("Hello, 2025 Python!")
    

    右键运行,若控制台输出预期内容,说明环境配置成功。

    文章配图

    三、常见问题排查

    1. 忘记勾选 Add to PATH 怎么办?
    • Windows:手动添加环境变量。右键'此电脑'→'属性'→'高级系统设置'→'环境变量'。在系统变量中找到 Path,编辑后新建条目,填入 Python 安装路径及 Scripts 路径。
    • macOS:在终端执行以下命令更新配置文件:
    echo 'export PATH="/usr/local/bin/python3:$PATH"' >> ~/.bash_profile
    source ~/.bash_profile
    
    2. 命令行提示'不是内部或外部命令'?

    检查环境变量是否正确添加,并确保重启了命令行窗口使配置生效。

    3. PyCharm 找不到 Python 解释器?

    确认 Python 安装路径无中文或空格。在 PyCharm 中通过 File → Settings → Project → Python Interpreter → Add 重新指定路径。

    4. 安装提示内存不足?

    关闭其他占用内存的程序(如浏览器、大型游戏)。若内存小于 4GB,建议考虑轻量级编辑器如 VS Code。

    5. macOS 下 python 命令指向旧版本?

    macOS 系统自带 Python 可能较旧,建议优先使用 python3 和 pip3 命令。也可通过 alias 设置别名:

    echo 'alias python="python3"' >> ~/.bash_profile
    

    四、总结

    搭建 Python 开发环境的核心在于正确配置环境变量以及 IDE 与解释器的关联。安装时请尽量使用纯英文路径,避免特殊字符干扰。遇到报错时,优先检查环境变量设置及路径合法性。更多详细信息可参考 Python 官方文档及 PyCharm 帮助中心。

    目录

    1. Python 与 PyCharm 环境搭建指南
    2. 一、Python 安装流程
    3. 1. 下载安装包
    4. 2. 执行安装
    5. 3. 验证安装
    6. macOS 可能需要使用 python3 --version
    7. macOS 可能需要使用 pip3 --version
    8. 二、PyCharm 安装与配置
    9. 1. 下载安装包
    10. 2. 安装步骤
    11. 3. 首次启动与解释器关联
    12. 三、常见问题排查
    13. 1. 忘记勾选 Add to PATH 怎么办?
    14. 2. 命令行提示“不是内部或外部命令”?
    15. 3. PyCharm 找不到 Python 解释器?
    16. 4. 安装提示内存不足?
    17. 5. macOS 下 python 命令指向旧版本?
    18. 四、总结
    • 💰 8折买阿里云服务器限时8折了解详情
    • 💰 8折买阿里云服务器限时8折购买
    • 🦞 5分钟部署阿里云小龙虾了解详情
    • 🤖 一键搭建Deepseek满血版了解详情
    • 一键打造专属AI 智能体了解详情
    极客日志微信公众号二维码

    微信扫一扫,关注极客日志

    微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

    更多推荐文章

    查看全部
    • AI 时代如何脱颖而出:商业认知与行动策略
    • C++ 类和对象(中):默认成员函数与运算符重载
    • 黄民烈:AI 赋能精神心理健康服务与数字疗法实践
    • AI 编程工具深度对比:Cursor、Copilot、Trae 与 Claude Code
    • OpenClaw 配置飞书机器人完整指南
    • 双指针算法进阶:从三角形到多数之和
    • VS Code 安装 OpenCode 插件及本地 AI 代码补全配置
    • 基于腾讯云轻量应用服务器部署 OpenClaw 并接入 QQ 与飞书机器人
    • C++ 继承机制:同名成员隐藏规则与默认函数详解
    • Windows 环境下编译部署 llama.cpp
    • AIGC 核心技术解析:GPT、BERT 与 Transformer 工作原理
    • C++ 继承机制详解
    • 基于 AR 的低代码可视化远程协作与工业巡检方案
    • Java 面向对象入门:类、对象与封装核心
    • FPGA 嵌入式块存储器 RAM:原理与实现
    • PyCharm 集成 GitHub Copilot:从安装到配置实战指南
    • Kubernetes 与 AI 推理服务最佳实践
    • 前端开发基础:HTML 常用标签与结构详解
    • 企业级 Java 登录注册系统构建指南:核心代码与配置
    • C++ Muduo 库(三)事件循环机制详解

    相关免费在线工具

    • RSA密钥对生成器

      生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

    • Mermaid 预览与可视化编辑

      基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

    • 随机西班牙地址生成器

      随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

    • curl 转代码

      解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

    • Base64 字符串编码/解码

      将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

    • Base64 文件转换器

      将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online