Python 解析器安装指南（Mac / Windows / Linux）

本文档提供在 macOS、Windows 和 Linux 系统上安装 Python 解析器的详细流程。

1. 安装包下载

1.1 Python 下载官网

所有系统安装包 官网地址

2.核心安装方式

3. macOS 系统安装

3.1 使用 Homebrew 安装（推荐）

1. 安装 Homebrew（如果未安装）：

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

2. 通过 Homebrew 安装 Python

brew install python

3.2 官网安装包

1. 通过上述系统地址下载安装包；
2. 双击 .pkg 文件，按照安装流程默认安装；

3.3 安装结果验证

# 打开终端输入命令，正常输出版本信息
python3 --version

4. Windows 系统安装

4.1安装步骤

1. 访问 Python 官网 下载 Windows 安装程序。

2. 双击下载的 .exe 文件：务必勾选 Add Python to PATH（将 Python 添加到环境变量）。
   

3. 如果步骤2没有勾选或自定义安装路径（则需要自行配置环境变量）。

		手动配置步骤（以 Windows 10/11 为例）
		a. 找到 Python 安装路径 
		   - 默认安装路径通常为：  
		     C:\Users\<用户名>\AppData\Local\Programs\Python\PythonXX 或 自定义的安装目录
		   - 若不确定，可通过以下方式查找：  
		     右键点击 Python 快捷方式 → 属性 → 查看“目标”路径中的安装位置。
		b. 打开系统环境变量设置 
		   - 按下 `Win + S`，搜索 **编辑系统环境变量** → 打开。  
		   - 点击底部 **环境变量(N)...** 按钮。
		c. 编辑 Path 变量
		   - 在 **系统变量** 或 **用户变量** 列表中找到 `Path` → 点击 **编辑**。  
		   - 点击 **新建**，添加以下两条路径（根据实际安装路径修改）：  
		    Python 主目录（python.exe所在的目录），例如主目录是：C:\Program Files\PythonXX\
		    pip所在的目录，C:\Program Files\PythonXX\Scripts\
		   （假设上述安装的目录是 C:\Program Files\PythonXX）

4.2 结果验证同Mac

5. Linux 系统安装

5.1 系统包管理器（推荐）

• Debian/Ubuntu

sudo apt update && sudo apt install python3

• Fedora

sudo dnf install python3

• Arch Linux

sudo pacman -S python

5.2 源码编译安装

1. 安装依赖

sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libsqlite3-dev libreadline-dev libffi-dev curl

2. 下载并解压源码

curl -O https://www.python.org/ftp/python/3.x.x/Python-3.x.x.tar.xz
tar -xf Python-3.x.x.tar.xz

3. 编译安装

cd Python-3.x.x
./configure --enable-optimizations
make -j 8
sudo make altinstall

5.3 Linux系统配置系统环境变量（以 Ubuntu/Debian 为例）

5.3.1 方法1：临时生效

export PATH="/path/to/python/bin:$PATH"
# 示例（Python 安装路径为 `/usr/local/python3.10/bin`）：
export PATH="/usr/local/python3.10/bin:$PATH"

5.3.2 永久生效（用户级配置）

1. 查找 Python 安装路径

which python3  # 查看默认 Python3 路径
 或
find / -name "python3.*" 2>/dev/null  # 搜索所有 Python3 路径

2. 编辑 Shell 配置文件
   • 如果使用 bash

   nano ~/.bashrc
   

   • 如果使用 zsh

   nano ~/.zshrc
   

3. 在文件末尾添加路径

   # 设置 Python 主目录和 pip 目录
   export PATH="/path/to/python/bin:$PATH"
   export PATH="/path/to/pip/bin:$PATH"
   # 示例（适用于通过源码安装到 `/opt/python3.10`）：
   export PATH="/opt/python3.10/bin:$PATH"
   

4. 使配置生效

source ~/.bashrc  # 或 source ~/.zshrc

5.4 结果验证同Mac

注意事项

• Python 2 已废弃，请使用 Python 3.x 版本。

• 推荐使用虚拟环境管理项目依赖：

  python3 -m venv myenv # 创建虚拟环境
  # 激活虚拟环境
  source myenv/bin/activate  # Linux/macOS
  myenv\Scripts\activate     # Windows
  

• 安装后可通过 pip 安装第三方包：

  pip install package-name