Python快速入门专业版(一):Windows/macOS/Linux 系统环境搭建(附常见报错解决)

目录

  • [1. 引言:为什么环境搭建是Python入门的"第一块砖"](#1. 引言:为什么环境搭建是Python入门的“第一块砖”)
    • [1.1 版本选择:为什么推荐Python 3.13.6?](#1.1 版本选择:为什么推荐Python 3.13.6?)
  • [2. Windows系统Python环境搭建(以Windows 10/11为例)](#2. Windows系统Python环境搭建(以Windows 10/11为例))
    • [2.1 前期准备:确认Windows系统位数(32位/64位)](#2.1 前期准备:确认Windows系统位数(32位/64位))
    • [2.2 官网下载Python安装包(分步拆解)](#2.2 官网下载Python安装包(分步拆解))
    • [2.3 安装过程:关键选项详解(避免90%的后续问题)](#2.3 安装过程:关键选项详解(避免90%的后续问题))
    • [2.4 安装后验证:用CMD命令行确认环境可用](#2.4 安装后验证:用CMD命令行确认环境可用)
    • [2.5 Windows安装常见小问题](#2.5 Windows安装常见小问题)
  • [3. macOS系统Python环境搭建(适配Intel/Apple Silicon芯片)](#3. macOS系统Python环境搭建(适配Intel/Apple Silicon芯片))
    • [3.1 前期准备:认识macOS的"自带Python坑"](#3.1 前期准备:认识macOS的“自带Python坑”)
    • [3.2 方式1:官网下载安装(最稳定,推荐新手)](#3.2 方式1:官网下载安装(最稳定,推荐新手))
    • [3.3 方式2:Homebrew安装(适合有终端基础的用户)](#3.3 方式2:Homebrew安装(适合有终端基础的用户))
    • [3.4 安装后验证:用终端确认Python 3可用](#3.4 安装后验证:用终端确认Python 3可用)
    • [3.5 macOS安装常见小问题](#3.5 macOS安装常见小问题)
  • [4. Linux系统Python环境搭建(适配Ubuntu/CentOS/Debian)](#4. Linux系统Python环境搭建(适配Ubuntu/CentOS/Debian))
    • [4.1 前期准备:检查系统预装的Python版本](#4.1 前期准备:检查系统预装的Python版本)
    • [4.2 Ubuntu/Debian系列:用apt-get安装(最便捷)](#4.2 Ubuntu/Debian系列:用apt-get安装(最便捷))
    • [4.3 CentOS/RHEL系列:用yum安装(需扩展源)](#4.3 CentOS/RHEL系列:用yum安装(需扩展源))
    • [4.4 源码编译安装(适合需要自定义版本的场景)](#4.4 源码编译安装(适合需要自定义版本的场景))
    • [4.5 Linux安装常见小问题](#4.5 Linux安装常见小问题)
  • [5. 跨系统常见报错解决方案(新手必看)](#5. 跨系统常见报错解决方案(新手必看))
  • [6. 环境测试:编写第一个Python程序"Hello World"](#6. 环境测试:编写第一个Python程序“Hello World”)
    • [6.1 选择编写工具(新手友好)](#6.1 选择编写工具(新手友好))
    • [6.2 步骤1:编写"Hello World"代码](#6.2 步骤1:编写“Hello World”代码)
    • [6.3 步骤2:运行程序(跨系统方法)](#6.3 步骤2:运行程序(跨系统方法))
    • [6.4 代码逐行解释:理解Python基础语法](#6.4 代码逐行解释:理解Python基础语法)
      • [第1行:`# 第一个Python程序:输出Hello World`](# 第一个Python程序:输出Hello World`)
      • [第2行:`print("Hello World")`](#第2行:print("Hello World"))
      • [利用Python 3.13新特性的变种示例](#利用Python 3.13新特性的变种示例)
  • [7. 总结与后续学习建议](#7. 总结与后续学习建议)
    • [7.1 环境搭建核心要点回顾](#7.1 环境搭建核心要点回顾)
    • [7.2 下一步学习方向](#7.2 下一步学习方向)

1. 引言:为什么环境搭建是Python入门的"第一块砖"

在编程学习中,"环境搭建"往往是新手遇到的第一个"拦路虎"------明明跟着教程操作,却可能因为一个没勾选的选项、一条没配置的路径,导致后续"python命令用不了""代码跑不通"等问题,最终打击学习信心。对于Python而言,环境搭建的核心是让操作系统找到Python的安装位置,并确保不同工具(如命令行、编辑器)能正常调用它,而这一切的关键在于"环境变量"和"安装路径"的配置。

本文将针对Windows、macOS、Linux三大主流操作系统,从"版本选择""官网下载""分步安装""安装验证"四个维度,手把手教你完成Python环境搭建;同时针对"python命令不可用""版本冲突"等高频报错,提供可直接操作的解决方案;最后通过经典的"Hello World"程序,验证环境是否可用,并带你理解Python代码的基础逻辑。

1.1 版本选择:为什么推荐Python 3.13.6?

Python目前分为Python 2和Python 3两个大版本,其中Python 2已于2020年1月1日停止官方支持(不再更新漏洞、修复bug),目前所有主流库(如NumPy、Pandas、Django)都只支持Python 3,因此新手必须选择Python 3。

在Python 3的众多版本中,推荐选择3.13.6(截至2025年9月的稳定版),原因如下:

  • 稳定性:3.13系列经过多轮迭代,修复了早期版本的多数兼容性问题,能适配99%以上的入门级库;
  • 新特性:包含模式匹配增强、性能优化(启动速度提升约15%)、类型提示改进等实用功能,提升编码效率;
  • 兼容性:作为3.13系列的后期版本,已解决初期发布时的库适配问题,同时保留了3.10+版本的核心特性,学习资料兼容性强。

本文将以Python 3.13.6为例,演示各系统的安装流程。

2. Windows系统Python环境搭建(以Windows 10/11为例)

Windows是国内多数新手的主力系统,其环境搭建的核心是勾选"Add Python to PATH" (自动配置环境变量)和自定义无中文、无空格的安装路径,这两步直接决定后续是否会出现"命令不可用"的问题。

2.1 前期准备:确认Windows系统位数(32位/64位)

Python安装包分"32位(x86)"和"64位(x86-64)",需根据系统位数选择,否则可能导致安装失败或性能问题。查看系统位数的步骤如下:

  1. 右键点击桌面"此电脑"(或"我的电脑"),选择"属性";
  2. 在"系统"页面中,找到"系统类型",即可看到"64位操作系统"或"32位操作系统"(目前主流电脑均为64位)。

2.2 官网下载Python安装包(分步拆解)

Python的官方下载地址为:https://www.python.org/downloads/(无需科学上网,直接访问),下载步骤如下:

  1. 打开官网后,页面会自动推荐"适合你系统的最新稳定版"(如"Download Python 3.13.6"),64位系统直接点击该按钮即可下载;
    • 若页面未自动识别(或需下载指定版本),可拉到页面下方的"Looking for a specific release?"区域,点击"Python 3.13.6"进入版本详情页;
  2. 在版本详情页的"Files"区域,根据系统位数选择安装包:
    • 64位系统:选择"Windows Installer (64-bit)"(文件名为python-3.13.6-amd64.exe);
    • 32位系统:选择"Windows Installer (32-bit)"(文件名为python-3.13.6.exe);
  3. 点击下载链接,等待安装包保存到本地(默认保存在"下载"文件夹,建议下载后移动到桌面,方便后续操作)。

2.3 安装过程:关键选项详解(避免90%的后续问题)

双击下载好的python-3.13.6-amd64.exe安装包,进入安装界面,每一步都需仔细核对选项,具体步骤如下:

  1. 第一步:勾选核心选项

    安装界面弹出后,务必先勾选"Add Python 3.13 to PATH"(这是自动配置环境变量的关键,默认未勾选!),然后点击"Customize installation"(自定义安装)------不推荐"Install Now"(默认安装),因为默认路径可能包含中文或空格(如"C:\Program Files\Python313"),后续可能引发权限问题。

  2. 第二步:选择"可选功能"

    进入"Optional Features"页面,默认已勾选以下选项,全部保留,无需修改,直接点击"Next":

    • Documentation:Python官方文档(离线查看);
    • pip:Python的包管理工具(后续安装第三方库必须用到);
    • tcl/tk and IDLE:Python自带的GUI工具和简易编辑器(入门可用);
    • Python test suite:Python测试套件(用于验证Python功能完整性);
    • py launcher:Windows下的Python版本管理工具(多版本共存时必备);
    • for all users:为所有系统用户安装(若电脑多人使用,建议勾选;单人使用可不勾)。
  3. 第三步:自定义安装路径与高级选项

    进入"Advanced Options"页面,重点配置以下两项:

    • Install location(安装路径) :点击"Browse"选择路径,建议设置为无中文、无空格的简单路径 ,例如D:\Python313(D盘根目录新建"Python313"文件夹)------路径中不能包含"中文"(如"Python安装")或"空格"(如"Python 313"),否则后续运行脚本可能报错;
    • 勾选"Associate files with Python":将.py文件与Python关联,双击.py文件可直接运行;
    • 其他选项默认勾选即可,点击"Install"开始安装,等待进度条完成(约1~2分钟)。
  4. 第四步:确认安装成功

    安装完成后,界面会显示"Setup was successful",点击"Close"关闭安装程序。

2.4 安装后验证:用CMD命令行确认环境可用

安装完成后,需通过命令行验证Python是否能被系统正常调用,步骤如下:

  1. 打开CMD命令行

    按下Win + R键,在弹出的"运行"窗口中输入cmd,按下回车(或点击"确定"),打开黑色的CMD窗口。

  2. 执行验证命令

    在CMD窗口中输入以下命令,按下回车:

    cmd 复制代码
    python --version

    若输出类似Python 3.13.6的内容,说明安装成功且环境变量配置正确;

    若输出pip --version,则会显示pip的版本(如pip 24.2 from D:\Python313\Lib\site-packages\pip (python 3.13)),说明pip也能正常使用。

    ⚠️ 注意:若打开CMD后执行命令失败,可尝试关闭CMD后重新打开(环境变量配置后需重启命令行生效),再重试命令。

2.5 Windows安装常见小问题

  • 问题1:安装时提示"权限不足"

    原因:安装路径选择了系统盘(如C盘)的受保护目录(如"Program Files")。

    解决:右键点击安装包,选择"以管理员身份运行",或重新选择D盘、E盘等非系统盘的路径(如D:\Python313)。

  • 问题2:安装后找不到Python文件夹

    原因:自定义路径时未记住位置,或勾选了"Install for all users"(路径可能在C:\Program Files\Python313)。

    解决:打开"此电脑",在右上角搜索框输入"Python313",即可找到文件夹位置。

3. macOS系统Python环境搭建(适配Intel/Apple Silicon芯片)

macOS系统自带Python 2.7(已停止支持),但无法满足Python 3的使用需求,因此必须手动安装Python 3。其环境搭建的核心是区分"python"和"python3"命令(避免与自带Python 2冲突),以及解决"权限不足"问题。

3.1 前期准备:认识macOS的"自带Python坑"

打开"启动台"→"其他"→"终端",输入以下命令:

bash 复制代码
python --version

若输出Python 2.7.18,说明系统自带Python 2.7------绝对不能用这个版本 (无安全更新、不支持新库),必须安装Python 3,且后续调用Python 3需用python3命令(而非python)。

此外,需确认macOS的芯片类型(Intel芯片/Apple Silicon芯片,如M1/M2/M3/M4),步骤如下:

  1. 点击屏幕左上角的苹果图标(🍎),选择"关于本机";
  2. 在"概览"页面中,"处理器"一栏显示"Intel Core i5/i7"即为Intel芯片,显示"Apple M1/M2/M3/M4"即为Apple Silicon芯片(下载安装包时需适配芯片类型)。

3.2 方式1:官网下载安装(最稳定,推荐新手)

Python官网会自动适配macOS芯片类型,下载步骤如下:

  1. 打开Python官网下载页:https://www.python.org/downloads/,点击"Download Python 3.13.6"(自动下载适配当前芯片的安装包);

    • 若需手动选择,进入版本详情页的"Files"区域:
      • Intel芯片:选择"macOS 64-bit installer"(文件名为python-3.13.6-macosx10.9.pkg);
      • Apple Silicon芯片:选择"macOS 64-bit universal2 installer"(文件名为python-3.13.6-macosx11.0.pkg,支持通用芯片)。
  2. 双击下载的.pkg安装包,进入安装向导:

    • 点击"继续"→"继续"→"同意"(许可协议);
    • 选择"安装位置"(默认安装到/Library/Frameworks/Python.framework/Versions/3.13,新手无需修改路径);
    • 输入macOS的开机密码(验证权限),点击"安装",等待进度条完成(约1~2分钟)。
  3. 关键步骤:运行"Install Certificates.command"

    安装完成后,需解决"SSL证书缺失"问题(否则后续用pip安装库会报错"SSL: CERTIFICATE_VERIFY_FAILED"):

    1. 打开"启动台"→"其他"→"终端";

    2. 输入以下命令,按下回车(自动运行证书安装脚本):

      bash 复制代码
      /Applications/Python\ 3.13/Install\ Certificates.command
    3. 等待脚本执行完成(显示"Certificates installed successfully"即可)。

3.3 方式2:Homebrew安装(适合有终端基础的用户)

Homebrew是macOS的包管理工具,用它安装Python可自动配置环境变量,且后续升级方便。若未安装Homebrew,需先执行以下命令安装:

bash 复制代码
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

(安装过程需输入开机密码,等待约5~10分钟,依赖网络环境)

安装Homebrew后,执行以下命令安装Python 3.13:

bash 复制代码
brew install python@3.13

Homebrew会自动将Python 3.13安装到/usr/local/Cellar/python@3.13/3.13.6,并配置环境变量。

3.4 安装后验证:用终端确认Python 3可用

无论用哪种方式安装,都需通过终端验证Python 3是否可用,步骤如下:

  1. 打开"终端"(启动台→其他→终端);

  2. 输入以下命令,按下回车:

    bash 复制代码
    python3 --version

    若输出Python 3.13.6,说明安装成功;

  3. 验证pip是否可用(Python 3对应的pip命令为pip3):

    bash 复制代码
    pip3 --version

    若输出类似pip 24.2 from /Library/Frameworks/Python.framework/Versions/3.13/lib/python3.13/site-packages/pip (python 3.13)的内容,说明pip3正常。

    ⚠️ 注意:macOS中,python命令默认指向自带的Python 2,python3才指向手动安装的Python 3,后续运行Python代码需用python3命令。

3.5 macOS安装常见小问题

  • 问题1:终端输入"python3"提示"command not found"

    原因:环境变量未配置(官网安装可能漏配,Homebrew安装一般不会)。

    解决:手动添加环境变量,终端输入以下命令(适用于bash终端):

    bash 复制代码
    echo 'export PATH="/Library/Frameworks/Python.framework/Versions/3.13/bin:$PATH"' >> ~/.bash_profile
    source ~/.bash_profile  # 生效环境变量

    若用zsh终端(macOS 10.15+默认),将.bash_profile替换为.zshrc即可。

  • 问题2:用pip3安装库提示"Permission denied"

    原因:权限不足(默认路径为系统目录,普通用户无写入权限)。

    解决:避免用sudo pip3(可能破坏系统文件),改用"用户级安装":

    bash 复制代码
    pip3 install --user 库名  # 例如 pip3 install --user numpy

4. Linux系统Python环境搭建(适配Ubuntu/CentOS/Debian)

Linux系统(如Ubuntu、CentOS)通常预装Python 3,但版本可能过低(如Ubuntu 22.04预装Python 3.10),若需安装3.13.6版本,需通过"包管理器安装"或"源码编译安装"。以下分"Ubuntu/Debian系列"和"CentOS/RHEL系列"演示,核心是区分"python"和"python3"命令,以及解决"依赖缺失"问题。

4.1 前期准备:检查系统预装的Python版本

打开终端(快捷键Ctrl + Alt + T),输入以下命令,查看当前Python版本:

bash 复制代码
python3 --version
  • 若输出Python 3.13.x及以上,说明版本满足需求,无需重新安装;
  • 若输出Python 3.12.x及以下,或提示"command not found",需安装Python 3.13.6。

4.2 Ubuntu/Debian系列:用apt-get安装(最便捷)

Ubuntu、Debian等系统用apt-get包管理器,安装步骤如下:

  1. 更新软件源列表(确保能找到最新的Python版本):

    bash 复制代码
    sudo apt update
  2. 安装Python 3.13.6及依赖

    • 若系统支持直接安装3.13(如Ubuntu 24.04+):

      bash 复制代码
      sudo apt install python3.13 python3.13-pip
    • 若系统不支持(如Ubuntu 22.04),需先添加第三方源(deadsnakes PPA):

      bash 复制代码
      sudo add-apt-repository ppa:deadsnakes/ppa  # 添加源
      sudo apt update  # 再次更新源
      sudo apt install python3.13 python3.13-pip  # 安装Python 3.13
  3. 设置Python 3.13为默认Python 3(可选,解决版本冲突):

    bash 复制代码
    # 建立软链接,将python3指向python3.13
    sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.13 1
    # 若需切换版本,执行以下命令选择对应版本
    sudo update-alternatives --config python3

4.3 CentOS/RHEL系列:用yum安装(需扩展源)

CentOS默认的软件源中Python版本较低,需先安装epel-release扩展源,步骤如下:

  1. 安装扩展源

    bash 复制代码
    sudo yum install epel-release
  2. 安装Python 3.13.6

    bash 复制代码
    sudo yum install python3.13 python3.13-pip
  3. 验证安装

    bash 复制代码
    python3.13 --version  # 输出Python 3.13.6
    pip3.13 --version     # 输出pip版本

    ⚠️ 注意:CentOS中,python命令默认指向Python 2(若预装),python3指向预装的Python 3,python3.13指向手动安装的3.13,需根据版本调用。

4.4 源码编译安装(适合需要自定义版本的场景)

若需安装特定版本(如3.13.6),或系统不支持包管理器安装,可通过"源码编译"安装,步骤如下(以Ubuntu为例):

  1. 安装编译依赖(缺少依赖会导致编译失败):

    bash 复制代码
    sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev wget
  2. 下载Python源码包

    bash 复制代码
    # 下载Python 3.13.6源码
    wget https://www.python.org/ftp/python/3.13.6/Python-3.13.6.tgz
  3. 解压源码包并进入目录

    bash 复制代码
    tar -zxvf Python-3.13.6.tgz  # 解压
    cd Python-3.13.6              # 进入解压后的目录
  4. 配置编译参数(指定安装路径)

    bash 复制代码
    # --prefix指定安装路径,建议设为/usr/local/python313
    ./configure --prefix=/usr/local/python313 --enable-optimizations
    # --enable-optimizations:启用编译优化,提升Python运行速度
  5. 编译并安装

    bash 复制代码
    make -j4  # 4线程编译(根据CPU核心数调整,如8核用-j8)
    sudo make install  # 安装到指定路径
  6. 配置环境变量

    bash 复制代码
    # 将Python路径添加到环境变量(永久生效)
    echo 'export PATH="/usr/local/python313/bin:$PATH"' >> ~/.bashrc
    source ~/.bashrc  # 生效环境变量
  7. 验证安装

    bash 复制代码
    python3 --version  # 输出Python 3.13.6
    pip3 --version     # 输出pip版本

4.5 Linux安装常见小问题

  • 问题1:编译时提示"no acceptable C compiler found in $PATH"

    原因:未安装C编译器(build-essential)。

    解决:Ubuntu/Debian用户执行sudo apt install build-essential,CentOS用户执行sudo yum install gcc

  • 问题2:输入"python3.13"提示"command not found"

    原因:源码安装后未配置环境变量,或路径错误。

    解决:检查安装路径(如/usr/local/python313/bin)是否存在python3.13文件,若存在,重新执行环境变量配置命令并生效。

5. 跨系统常见报错解决方案(新手必看)

无论哪个系统,安装Python后最常遇到的问题是"命令不可用"和"版本冲突",以下针对每个报错,提供"现象-原因-解决方案"的完整流程,确保你能独立排查。

5.1 报错1:"python --version"提示"命令未找到"(或"'python' 不是内部或外部命令")

现象

  • Windows CMD:'python' 不是内部或外部命令,也不是可运行的程序或批处理文件。
  • macOS/Linux终端:bash: python: command not found

原因(核心:系统找不到Python的安装路径)

  1. 安装时未勾选"Add Python to PATH"(Windows),或未配置环境变量(macOS/Linux);
  2. 环境变量配置后未重启命令行(CMD/终端);
  3. 安装路径包含中文或空格(Windows),导致环境变量失效。

解决方案(分系统操作)

Windows系统:手动配置环境变量
  1. 右键点击"此电脑"→"属性"→"高级系统设置"→"环境变量";
  2. 在"用户变量"或"系统变量"中,找到"Path"变量,点击"编辑";
  3. 点击"新建",添加Python的"安装目录"和"Scripts目录"(例如:
    • 安装目录:D:\Python313
    • Scripts目录:D:\Python313\Scripts(pip所在目录)
  4. 点击"确定"保存所有窗口,关闭CMD后重新打开 ,再次执行python --version
macOS系统:手动添加环境变量
  1. 终端输入以下命令(根据终端类型选择):

    • bash终端(默认):

      bash 复制代码
      echo 'export PATH="/Library/Frameworks/Python.framework/Versions/3.13/bin:$PATH"' >> ~/.bash_profile
      source ~/.bash_profile  # 生效
    • zsh终端(macOS 10.15+默认):

      bash 复制代码
      echo 'export PATH="/Library/Frameworks/Python.framework/Versions/3.13/bin:$PATH"' >> ~/.zshrc
      source ~/.zshrc  # 生效
  2. 执行python3 --version(macOS需用python3),验证是否成功。

Linux系统:修复环境变量
  1. 终端输入以下命令(以源码安装路径/usr/local/python313为例):

    bash 复制代码
    echo 'export PATH="/usr/local/python313/bin:$PATH"' >> ~/.bashrc
    source ~/.bashrc  # 生效
  2. 执行python3 --version,验证是否成功。

5.2 报错2:版本冲突(安装多个Python版本,命令调用混乱)

现象

  • 执行python --version显示Python 2.7,而想调用Python 3.13;
  • 执行pip install 库名后,在Python 3.13中无法导入该库(库安装到了Python 2中)。

原因

系统中安装了多个Python版本(如Python 2.7、3.10、3.13),python/pip命令默认指向旧版本,导致调用错误。

解决方案(分系统管理多版本)

Windows系统:用py launcher切换版本

Windows安装Python时默认自带py命令(版本管理器),可通过py -版本号调用指定版本:

  1. 查看系统中已安装的Python版本:

    cmd 复制代码
    py -0  # 输出类似:-3.13-64 * Python 3.13.6 (64-bit)
  2. 调用指定版本的Python:

    cmd 复制代码
    py -3.13 --version  # 调用Python 3.13
    py -3.13 -m pip install 库名  # 用Python 3.13的pip安装库
  3. (可选)设置Python 3.13为默认:
    右键点击"此电脑"→"属性"→"高级系统设置"→"环境变量",在"Path"中,将Python 3.13的路径(如D:\Python313)移到Python 2.7路径的上方,保存后重启CMD。

macOS/Linux系统:用alias或update-alternatives切换
  1. 临时切换(当前终端生效)

    终端输入以下命令,将python指向python3.13

    bash 复制代码
    alias python="python3.13"
    alias pip="pip3.13"

    验证:python --version输出Python 3.13.6。

  2. 永久切换(所有终端生效)

    • bash终端:

      bash 复制代码
      echo 'alias python="python3.13"' >> ~/.bash_profile
      echo 'alias pip="pip3.13"' >> ~/.bash_profile
      source ~/.bash_profile
    • zsh终端:

      bash 复制代码
      echo 'alias python="python3.13"' >> ~/.zshrc
      echo 'alias pip="pip3.13"' >> ~/.zshrc
      source ~/.zshrc
  3. Linux系统:用update-alternatives管理(推荐)

    bash 复制代码
    # 为Python 3.13建立软链接
    sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.13 100
    # 为Python 3.10建立软链接(若存在)
    sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.10 50
    # 选择默认Python 3版本(输入编号选择3.13)
    sudo update-alternatives --config python3

5.3 报错3:pip命令不可用("pip --version"提示"命令未找到")

现象

  • Windows:'pip' 不是内部或外部命令
  • macOS/Linux:bash: pip: command not found

原因

  1. 安装Python时未勾选"pip"选项(Windows);
  2. pip的路径未添加到环境变量(Scripts目录,Windows);
  3. 调用命令错误(macOS/Linux需用pip3,而非pip)。

解决方案

Windows系统:修复pip路径
  1. 找到Python的"Scripts目录"(如D:\Python313\Scripts),确认该目录下是否有pip.exe文件;

  2. 若有,按照"报错1"的步骤,将该目录添加到"Path"环境变量,重启CMD后执行pip --version

  3. 若没有(未安装pip),打开CMD执行以下命令(重新安装pip):

    cmd 复制代码
    python -m ensurepip --upgrade
macOS/Linux系统:用Python调用pip
  1. 直接通过Python调用pip(避免命令冲突):

    bash 复制代码
    python3 -m pip --version  # 验证pip是否存在
  2. 若输出pip版本,可设置alias(永久生效):

    bash 复制代码
    echo 'alias pip="python3 -m pip"' >> ~/.bashrc  # bash终端
    source ~/.bashrc
  3. 若提示"no module named pip",执行以下命令安装pip:

    bash 复制代码
    python3 -m ensurepip --upgrade

5.4 报错4:Windows运行脚本提示"无法加载文件,因为在此系统上禁止运行脚本"

现象

双击.py文件或在CMD中执行python hello.py时,提示:

复制代码
无法加载文件 D:\hello.py,因为在此系统上禁止运行脚本。有关详细信息,请参阅 https:/go.microsoft.com/fwlink/?LinkID=135170 中的 about_Execution_Policies。

原因

Windows的PowerShell执行策略默认禁止运行脚本(保护系统安全),CMD中调用Python时可能触发该限制。

解决方案

  1. 以"管理员身份"打开PowerShell:
    右键点击"开始菜单"→"Windows PowerShell (管理员)";

  2. 执行以下命令,修改执行策略:

    powershell 复制代码
    Set-ExecutionPolicy RemoteSigned
  3. 输入Y确认,关闭PowerShell后重新打开CMD,再次运行脚本即可。

6. 环境测试:编写第一个Python程序"Hello World"

环境搭建完成后,我们通过经典的"Hello World"程序验证环境是否能正常运行,并带你理解Python代码的基础逻辑。

6.1 选择编写工具(新手友好)

无需安装复杂的IDE(如PyCharm),用系统自带的工具即可:

  • Windows:记事本(Notepad)或"IDLE"(Python自带,在开始菜单中搜索"IDLE");
  • macOS:文本编辑(需将格式设为"纯文本",避免自动添加格式);
  • Linux:Gedit(文本编辑器)或终端直接编写(nano hello.py)。

本文以"记事本"和"终端"为例,演示编写与运行流程。

6.2 步骤1:编写"Hello World"代码

用记事本编写(Windows)

  1. 打开"记事本"(Win+R输入notepad);

  2. 在记事本中输入以下代码(注意符号为英文半角):

    python 复制代码
    # 第一个Python程序:输出Hello World
    print("Hello World")
  3. 点击"文件"→"保存",选择保存路径(如D:\Projects,需先新建"Projects"文件夹),文件名设为hello.py,"保存类型"选择"所有文件","编码"选择"UTF-8"(避免中文注释乱码),点击"保存"。

用终端编写(macOS/Linux)

  1. 打开终端,输入以下命令,新建并编辑hello.py文件:

    bash 复制代码
    # 进入用户目录(或自定义目录,如cd ~/Projects)
    cd ~
    # 用nano编辑器新建文件
    nano hello.py
  2. 在nano中输入代码(与上述一致):

    python 复制代码
    # 第一个Python程序:输出Hello World
    print("Hello World")
  3. 按下Ctrl + O(保存),按下回车确认文件名,再按下Ctrl + X(退出nano)。

6.3 步骤2:运行程序(跨系统方法)

运行Python程序的核心是"用正确的Python命令,指向正确的.py文件路径",以下分系统演示:

Windows系统(CMD)

  1. 打开CMD,进入hello.py所在的目录(如D:\Projects):

    cmd 复制代码
    cd D:\Projects  # 切换目录(注意盘符大写)
    dir  # 查看目录下是否有hello.py文件
  2. 执行以下命令,运行程序:

    cmd 复制代码
    python hello.py
  3. 若输出Hello World,说明环境完全正常!

macOS/Linux系统(终端)

  1. 打开终端,进入hello.py所在的目录(如~/Projects):

    bash 复制代码
    cd ~/Projects  # 切换目录
    ls  # 查看目录下是否有hello.py文件
  2. 执行以下命令,运行程序(需用python3):

    bash 复制代码
    python3 hello.py
  3. 若输出Hello World,说明环境完全正常!

6.4 代码逐行解释:理解Python基础语法

虽然hello.py只有2行代码,但包含了Python的核心语法规则,逐行解释如下:

第1行:# 第一个Python程序:输出Hello World

  • 作用:注释(对代码的说明,Python运行时会忽略注释);

  • 语法规则 :以#开头的行都是注释,用于记录代码功能、作者、日期等信息,方便自己或他人后续阅读;

  • 示例

    python 复制代码
    # 这是单行注释
    # 作者:Python新手
    # 日期:2025年9月

    第2行:print("Hello World")

  • 作用 :调用Python的内置函数print(),在控制台输出括号中的内容("Hello World");

  • 逐部分解析

    1. print:Python的内置函数(无需额外安装,直接可用),功能是"输出内容到控制台";
    2. ():函数调用的标志,所有函数都需用()包裹参数(即使无参数,也需写print());
    3. "Hello World"字符串 (文本数据),需用英文半角的""''包裹(如'Hello'也可),若用中文引号("")会报错;
  • 语法规则 :Python语句无需用;结尾(与Java、C++不同),换行即表示语句结束;若一行写多个语句,需用;分隔(不推荐新手使用)。

利用Python 3.13新特性的变种示例

Python 3.13支持更简洁的字符串格式化和模式匹配,可尝试以下代码体验新特性:

python 复制代码
# 使用Python 3.13增强的f-string语法
name = "Python 3.13"
print(f"Hello, {name=}!")  # 输出:Hello, name='Python 3.13'!

# 使用模式匹配(3.10+引入,3.13增强)
message = "Hello World"
match message:
    case "Hello World":
        print("匹配成功:这是经典问候语")
    case _:
        print("未匹配到预设内容")

运行后输出:

复制代码
Hello, name='Python 3.13'!
匹配成功:这是经典问候语

7. 总结与后续学习建议

7.1 环境搭建核心要点回顾

  1. 版本选择:坚决使用Python 3.13.6,拒绝Python 2;
  2. 路径配置:安装路径必须"无中文、无空格"(Windows关键);
  3. 环境变量:确保Python的安装目录和Scripts目录(Windows)添加到Path,这是解决"命令不可用"的核心;
  4. 命令区分 :Windows用python/pip,macOS/Linux用python3/pip3(避免与自带版本冲突);
  5. 验证流程 :安装后先执行python --versionpip --version,再运行"Hello World",确保每一步都验证。

7.2 下一步学习方向

  1. 熟悉Python 3.13新特性:重点掌握模式匹配增强、性能优化点、类型提示改进等,提升编码效率;
  2. 选择合适的IDE:新手推荐VS Code(轻量、免费、插件丰富),安装"Python"插件后可实现代码补全、语法检查;
  3. 学习使用pip :用pip install 库名安装第三方库(如pip install numpy安装数据分析库),开启Python的"生态之旅"。

环境搭建是Python入门的"第一步",也是最关键的一步------只要环境正常,后续的语法学习、项目开发都会顺畅很多。如果遇到其他问题,可通过Python官方文档(https://docs.python.org/3.13/)或社区(如Stack Overflow)搜索解决方案,培养独立排查问题的能力。

相关推荐
max5006004 小时前
YOLOv8主干网络替换为UniConvNet的详细指南
运维·开发语言·人工智能·python·算法·yolo
腾讯云qcloud07554 小时前
腾讯位置商业授权微信小程序获取城市列表
python·腾讯云ai代码助手
大模型真好玩4 小时前
深入浅出LangGraph AI Agent智能体开发教程(三)—LangGraph工具调用实战
人工智能·python·mcp
高级测试工程师欧阳5 小时前
SQLint3 模块如何使用
数据库·python·mysql·oracle
LeonDL1685 小时前
【通用视觉框架】基于Python+OpenCV+PyQt5开发的视觉框架软件,全套源码,开箱即用
图像处理·人工智能·python·opencv·pyqt5·通用视觉框架软件·机器视觉软件框架
一心0925 小时前
SQL(window)日志在linux 下查看
linux·数据库·windows·sql·日志
摘星编程5 小时前
Cursor 辅助开发:快速搭建 Flask + Vue 全栈 Demo 的实战记录
vue.js·python·flask·cursor·ai辅助编程
图灵信徒5 小时前
ICPC Central Russia Regional Contest, 2024
c++·python·codeforces·算法竞赛
UrbanJazzerati5 小时前
Excel自动化实战:使用Python实现Salesforce Flow翻译版本同步
python·面试