跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonVScode大前端

Python 与 PyCharm 安装与排错指南

这份内容整理了 Python 3.13.x 和 PyCharm 在 Windows 10/11、macOS Sonoma 上的安装流程,以及最常见的环境变量、解释器和命令行识别问题。重点是安装 Python 时勾选 Add to PATH、尽量使用清晰的安装路径、在 PyCharm 中手动指定已有的 python.exe。遇到 python 命令不可用、PyCharm 找不到解释器或 macOS 上 python 指向旧版本时,分别通过环境变量、重开终端、使用 python3 或设置别名来处理。

观心发布于 2026/6/300 浏览
Python 与 PyCharm 安装与排错指南

前言

Python 现在几乎成了入门编程的默认选择,数据分析、AI、Web 开发都绕不开它。PyCharm 是 JetBrains 的 Python IDE,功能完整,界面也算顺手,适合想把环境一次配好的开发者。

这份记录只讲一件事:在 Windows 10/11 和 macOS Sonoma 上,把 Python 3.13.x 和 PyCharm 装好,并把最容易踩的几个坑提前处理掉。很多问题看起来像 PyCharm 的锅,实际往往是 Python 路径、环境变量或解释器选择出了偏差。

一、安装 Python

1. 下载安装包

先打开 Python 官网:https://www.python.org/

  • Windows:进入 Downloads,官网一般会直接识别系统并给出推荐安装包,比如 python-3.13.9-amd64.exe。
  • macOS:在 Downloads 里选 macOS,再按芯片类型下载对应版本。Intel 机型和 M 系列芯片不要混着装。

2025 年的 Python 3.13.x 对 Windows 11 和 macOS Sonoma 已经没有兼容性上的新麻烦,正常装就行。

2. 安装过程

以下以 Windows 为例,macOS 的思路基本一致。

双击安装包后,先别急着点默认安装。

  • 勾选 Add Python 3.13 to PATH。版本号会随安装包变化,别照抄旧教程里的 3.8。
  • 进入 Customize installation,比 Install Now 更稳,至少能把路径看清楚。

接下来保持 Optional Features 默认全选,通常 pip、IDLE 这些都应该留着。

在 Advanced Options 里,建议把路径改成更直白的位置,比如 D:\Python。路径里尽量别放中文,也别塞太多空格,后面出问题时省很多事。

装完后,如果提示 Disable path length limit,直接点掉。这个在 Windows 上算是小动作,但不少莫名其妙的路径问题都能少碰一点。

3. 验证是否安装成功

打开命令行:

  • Windows:Win + R,输入 cmd
  • macOS:打开「终端」

然后检查版本:

python --version # 或 python3 --version(macOS 可能需要)

如果输出类似 Python 3.13.0,说明 Python 已经能被命令行找到。

再看一下 pip:

pip --version # 或 pip3 --version

能正常返回版本信息就可以继续往下走。

二、安装 PyCharm

PyCharm 有两个常见版本:

  • 社区版(Community):免费,足够做学习和大多数普通开发。
  • 专业版(Professional):付费,Web、数据库这类功能更全。

如果只是想把 Python 跑起来,社区版已经够用。

1. 下载 PyCharm

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

  • Windows:下载 .exe 安装包
  • macOS:下载 .dmg 安装包

2. 安装 PyCharm

Windows 下双击安装包,按向导继续即可。

我一般会做两件事:

  • 改安装路径,别默认塞进系统目录
  • 勾选桌面快捷方式,后面找起来省事

然后一路安装到结束,Finish 之后就能启动了。

3. 首次启动并配置解释器

第一次打开 PyCharm,遇到 Import PyCharm Settings,选 Do not import settings 就行,没必要把旧配置硬搬过来。

新建项目时,重点不是点得多快,而是解释器要选对:

  1. 点 New Project
  2. 设好项目路径,比如 D:\PythonProjects\FirstProject
  3. 在 Python Interpreter 里点 Add Interpreter
  4. 选 Existing environment
  5. 浏览到本机安装的 python.exe,例如 D:\Programs\Python313\python.exe
  6. 勾上 Create a main.py welcome script,创建项目

创建完成后,打开 main.py,先跑一段最普通的代码:

print("Hello, 2025 Python!")

如果运行后控制台能看到同样的输出,PyCharm 和 Python 就算真正连上了。

三、常见问题

1. 安装 Python 时忘了勾 Add to PATH

这个最常见。结果就是命令行里输入 python 没反应,或者提示找不到命令。

  • Windows:手动把 Python 安装目录和 Scripts 目录加到环境变量 Path 里
  • macOS:可以用终端改 shell 配置,不过更稳的做法还是确认自己调用的是 python3

Windows 下路径大概长这样:

  • D:\Programs\Python313
  • D:\Programs\Python313\Scripts

2. 输入 python 提示不是内部或外部命令

优先检查两件事:

  • 环境变量有没有配对
  • 配完之后有没有重开命令行

很多人改完 Path 立刻测试,结果还是老报错,其实只是旧窗口没刷新。

3. PyCharm 找不到解释器

通常不是 PyCharm 坏了,而是解释器路径选错了。

  • 确认 python.exe 的实际位置
  • 尽量别把 Python 装在带中文或空格的目录里
  • 在 File → Settings → Project: XXX → Python Interpreter 里重新指定一次

4. 安装 PyCharm 时提示 Insufficient memory

这类提示一般跟内存有关,不是安装包本身出问题。

先关掉占内存的程序,再重试。电脑内存太小的话,PyCharm 本身就不算轻,继续硬装也未必舒服;这种情况下用 VS Code 更省心。

5. macOS 上 python 指向系统旧版本

这是 macOS 的老习惯:系统里常常区分 python 和 python3。

直接用 python3、pip3 最省事。

如果你就是想敲 python,也可以自己加别名:

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

不过这类改法只是让输入更顺手,不会改变系统里 Python 的实际版本。

四、结语

Python 和 PyCharm 的安装并不复杂,真正常卡人的往往是三处:PATH、解释器路径、以及 macOS 上命令名的差异。把这三件事处理好,后面的开发环境基本就稳了。

如果还想继续查官方信息,可以直接看 Python 文档:https://docs.python.org/3/,以及 PyCharm 帮助中心:https://www.jetbrains.com/help/pycharm/。

目录

  1. 前言
  2. 一、安装 Python
  3. 1. 下载安装包
  4. 2. 安装过程
  5. 3. 验证是否安装成功
  6. 二、安装 PyCharm
  7. 1. 下载 PyCharm
  8. 2. 安装 PyCharm
  9. 3. 首次启动并配置解释器
  10. 三、常见问题
  11. 1. 安装 Python 时忘了勾 Add to PATH
  12. 2. 输入 python 提示不是内部或外部命令
  13. 3. PyCharm 找不到解释器
  14. 4. 安装 PyCharm 时提示 Insufficient memory
  15. 5. macOS 上 python 指向系统旧版本
  16. 四、结语
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • 用 PyMobileDevice3 管理 iOS 设备
  • 在 Linux 上把 OpenClaw 接到 QQ 机器人
  • Linux 下用 gdb 和 cgdb 调试 C/C++
  • LeetCode 962 最大宽度坡的 C 语言做法
  • 用 ImGui 快速搭一个 C++ 调试面板
  • 用 Python 把 CSV 导入 Neo4j 的实操记录
  • Python 与 CV 大模型下的滑块与点选验证码处理思路
  • OpenClaw 接入 QQ 的部署记录
  • 用 Verilog 做 FPGA 浮点运算和 PID 控制
  • 次模函数与机器学习中的离散优化
  • 金仓 KES V9 兼容 MongoDB 的运维替代思路
  • MySQL 用 ON DUPLICATE KEY UPDATE 做 Upsert
  • VNCTF 2026 Web 题解整理
  • Qwen3 30B A3B Python Coder 使用笔记
  • Ubuntu 24.04 LTS 虚拟机安装与常用配置
  • 在 Photoshop 里用 WebPShop 处理 WebP
  • VRCT 配置与使用要点:给 VRChat 跨语言交流补一层实时转写
  • 用 Python 把 CSV 导进 Neo4j
  • Windows 下升级 Python 3.12 与多版本管理
  • 用 MCP 扩展 Chrome DevTools 做 JS 逆向

相关免费在线工具

  • curl 转代码

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

  • Base64 字符串编码/解码

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

  • Base64 文件转换器

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

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online