摘要：本文整理了在 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。解决方案：# 方案一：强制安装/修复 pippython-mensurepip--upgrade# 方案二：使用 python -m pip 代替 pippython-mpipinstall包名# 方案三：下载 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 验证）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\activate1.2 macOS 系统❌ 问题1：系统自带 Python 2.x 冲突现象：终端输入python显示 Python 2.7，而不是新安装的 Python 3。原因：macOS 系统自带 Python 2.x，且默认命令指向旧版
