Python 3、VS Code、PyCharm 安装常见问题及解决方案大全（Windows/Mac/Linux）

摘要：本文整理了在 Windows、macOS、Linux 三大操作系统上安装 Python 3、配置 VS Code 和 PyCharm 时最常见的错误及解决方案，帮助开发者快速定位并解决问题，顺利完成开发环境搭建。

目录

1. Python 3 安装常见问题
   • Windows 系统
   • macOS 系统
   • Linux 系统
2. VS Code Python 环境配置问题
3. PyCharm 配置常见问题
4. 通用解决方案速查表

一、Python 3 安装常见问题

1.1 Windows 系统

❌ 问题1：‘python’ 不是内部或外部命令

现象：在 CMD 中输入python或python --version时，提示"‘python’ 不是内部或外部命令，也不是可运行的程序或批处理文件"。

原因：安装 Python 时未勾选 “Add Python to PATH” 选项，导致系统无法找到 Python 可执行文件。

解决方案：

方案一：重新安装（推荐）

1. 卸载当前 Python
2. 重新运行安装程序
3. 务必勾选“Add Python 3.x to PATH”
4. 完成安装

方案二：手动添加环境变量

1. 右键"此电脑" → “属性” → “高级系统设置” → “环境变量”
2. 在"系统变量"中找到 “Path”，点击"编辑"
3. 点击"新建"，添加以下两个路径：
   • C:\Python39（Python 安装目录）
   • C:\Python39\Scripts（pip 等工具目录）
4. 点击"确定"保存，重启 CMD后生效

❌ 问题2：pip 命令不可用

现象：输入pip或pip install时提示"‘pip’ 不是内部或外部命令"。

原因：pip 未安装或未添加到 PATH。

解决方案：

# 方案一：强制安装/修复 pippython-mensurepip--upgrade# 方案二：使用 python -m pip 代替 pippython-mpipinstall包名# 方案三：下载 get-pip.py 安装# 访问 https://bootstrap.pypa.io/get-pip.py 下载脚本python get-pip.py

❌ 问题3：安装时权限不足

现象：安装过程中提示"需要管理员权限"或安装失败。

解决方案：

1. 右键点击安装程序，选择"以管理员身份运行"
2. 或者关闭杀毒软件/防火墙后重试
3. 安装路径避免使用C:\Program Files，建议选择C:\Python39或D:\Python

❌ 问题4：SSL 证书错误

现象：使用 pip 安装包时提示SSL: CERTIFICATE_VERIFY_FAILED。

原因：企业网络、代理环境或系统证书问题。

解决方案：

# 临时方案（使用国内镜像源，跳过 SSL 验证）pipinstall包名-ihttp://pypi.douban.com/simple/ --trusted-host pypi.douban.com# 永久方案：配置国内镜像源pip configsetglobal.index-url https://pypi.tuna.tsinghua.edu.cn/simple

❌ 问题5：多版本 Python 冲突

现象：安装了多个 Python 版本，命令行调用混乱。

解决方案：

# 使用 py launcher 管理多版本（Windows 特有）py-0# 列出所有已安装的 Python 版本py-3.9# 使用 Python 3.9py-3.11# 使用 Python 3.11# 创建虚拟环境隔离py-3.11-mvenv myenv myenv\Scripts\activate

1.2 macOS 系统

❌ 问题1：系统自带 Python 2.x 冲突

现象：终端输入python显示 Python 2.7，而不是新安装的 Python 3。

原因：macOS 系统自带 Python 2.x，且默认命令指向旧版