摘要:本文整理了在 Windows、macOS、Linux 三大操作系统上安装 Python 3、配置 VS Code 和 PyCharm 时最常见的错误及解决方案,帮助开发者快速定位并解决问题,顺利完成开发环境搭建。
目录
- Windows 系统
- macOS 系统
- Linux 系统
一、Python 3 安装常见问题
1.1 Windows 系统
❌ 问题1:‘python’ 不是内部或外部命令
现象:在 CMD 中输入 python 或 python –version 时,提示\”‘python’ 不是内部或外部命令,也不是可运行的程序或批处理文件\”。
原因:安装 Python 时未勾选 “Add Python to PATH” 选项,导致系统无法找到 Python 可执行文件。
解决方案:
方案一:重新安装(推荐)
方案二:手动添加环境变量
- C:\\Python39(Python 安装目录)
- C:\\Python39\\Scripts(pip 等工具目录)
❌ 问题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:安装时权限不足
现象:安装过程中提示\”需要管理员权限\”或安装失败。
解决方案:
❌ 问题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,且默认命令指向旧版



![第5章,[Win32 章节] :边框绘制函数(六)-171主机测评](https://www.171host.com/wp-content/uploads/2026/08/20260822144238-6a89b55eb002b-220x150.png)

