欢迎光临
我们一直在努力

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

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


目录

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

  • 一、Python 3 安装常见问题

    1.1 Windows 系统

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

    现象:在 CMD 中输入 python 或 python –version 时,提示\”‘python’ 不是内部或外部命令,也不是可运行的程序或批处理文件\”。

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

    解决方案:

    方案一:重新安装(推荐)

  • 卸载当前 Python
  • 重新运行安装程序
  • 务必勾选 “Add Python 3.x to PATH”
  • 完成安装
  • 方案二:手动添加环境变量

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

  • ❌ 问题2:pip 命令不可用

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

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

    解决方案:

    # 方案一:强制安装/修复 pip
    python -m ensurepip –upgrade

    # 方案二:使用 python -m pip 代替 pip
    python -m pip install 包名

    # 方案三:下载 get-pip.py 安装
    # 访问 https://bootstrap.pypa.io/get-pip.py 下载脚本
    python get-pip.py


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

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

    解决方案:

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

  • ❌ 问题4:SSL 证书错误

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

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

    解决方案:

    # 临时方案(使用国内镜像源,跳过 SSL 验证)
    pip install 包名 -i http://pypi.douban.com/simple/ –trusted-host pypi.douban.com

    # 永久方案:配置国内镜像源
    pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple


    ❌ 问题5:多版本 Python 冲突

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

    解决方案:

    # 使用 py launcher 管理多版本(Windows 特有)
    py -0 # 列出所有已安装的 Python 版本
    py -3.9 # 使用 Python 3.9
    py -3.11 # 使用 Python 3.11

    # 创建虚拟环境隔离
    py -3.11 -m venv myenv
    myenv\\Scripts\\activate


    1.2 macOS 系统

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

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

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

    赞(0)
    未经允许不得转载:171主机测评 » Python 3、VS Code、PyCharm 安装常见问题及解决方案大全(Windows/Mac/Linux)
    分享到: 更多 (0)

    评论 抢沙发

    • 昵称 (必填)
    • 邮箱 (必填)
    • 网址