OneYoung

Appearance

1. Python 安装 ​

1-1. 下载 Python ​

  1. 访问官方网站

    • 打开 Python 官网
    • 点击"Download Python"按钮
    • 选择最新的稳定版本（目前是 Python 3.12.x）

  2. 选择操作系统版本

    • Windows：下载 .exe 安装包
    • macOS：下载 .pkg 安装包
    • Linux：使用包管理器安装

1-2. 安装步骤 ​

Windows 安装 ​

  1. 运行下载的 .exe 文件
  2. 勾选"Add Python to PATH"选项
  3. 点击"Install Now"进行安装
  4. 等待安装完成

macOS 安装 ​

  1. 双击下载的 .pkg 文件
  2. 按照安装向导的提示进行操作
  3. 输入管理员密码（如果需要）
  4. 等待安装完成

Linux 安装 ​

bash
# Ubuntu/Debian
sudo apt update
sudo apt install python3 python3-pip

# CentOS/RHEL
sudo yum install python3 python3-pip

# Fedora
sudo dnf install python3 python3-pip

1-3. 验证安装 ​

打开终端或命令提示符，输入以下命令验证安装：

bash
# 检查 Python 版本
python --version
# 或
python3 --version

# 检查 pip 版本
pip --version
# 或
pip3 --version

# 进入 Python 交互式环境
python
# 或
python3

2. 开发环境配置 ​

2-1. 虚拟环境 ​

虚拟环境可以为不同项目创建独立的 Python 环境，避免包冲突。

bash
# 创建虚拟环境
python -m venv myenv

# 激活虚拟环境
# Windows
myenv\Scripts\activate

# macOS/Linux
source myenv/bin/activate

# 退出虚拟环境
deactivate

2-2. 包管理工具 ​

  1. pip 升级
bash
# Windows
python -m pip install --upgrade pip

# macOS/Linux
pip3 install --upgrade pip
  1. 常用包安装
bash
# 安装常用包
pip install numpy pandas matplotlib requests

# 安装开发工具
pip install black pylint pytest

3. IDE 选择与配置 ​

3-1. PyCharm（推荐） ​

  1. 下载安装

    • 访问 PyCharm 官网
    • 选择社区版（免费）或专业版
    • 下载并安装

  2. 基本配置

    • 选择 Python 解释器
    • 配置代码风格
    • 安装常用插件

3-2. VS Code ​

  1. 安装步骤

    • 下载安装 VS Code
    • 安装 Python 扩展
    • 安装其他推荐扩展

  2. 推荐扩展

    • Python（Microsoft）
    • Pylance
    • Python Test Explorer
    • Python Indent
    • autoDocstring

  3. 配置设置

json
{
    "python.defaultInterpreterPath": "python路径",
    "python.linting.enabled": true,
    "python.formatting.provider": "black",
    "editor.formatOnSave": true
}

4. 环境变量配置 ​

4-1. Windows 环境变量 ​

  1. 右键"此电脑" -> 属性 -> 高级系统设置 -> 环境变量
  2. 在"系统变量"中找到 Path
  3. 添加 Python 安装目录和 Scripts 目录

4-2. macOS/Linux 环境变量 ​

编辑 ~/.bashrc 或 ~/.zshrc：

bash
# 添加以下内容
export PATH="/usr/local/bin:$PATH"
export PATH="$HOME/Library/Python/3.x/bin:$PATH"

5. 常见问题解决 ​

5-1. 安装问题 ​

  1. 权限问题

    • Windows：以管理员身份运行安装程序
    • macOS/Linux：使用 sudo 命令

  2. 路径问题

    • 确保 Python 已添加到系统环境变量
    • 检查 PATH 环境变量设置

5-2. 运行问题 ​

  1. 版本冲突

    • 使用虚拟环境隔离项目
    • 检查 Python 版本兼容性

  2. 包安装失败

    • 检查网络连接
    • 使用国内镜像源
    bash
    pip install -i https://pypi.tuna.tsinghua.edu.cn/simple 包名

6. 推荐配置 ​

6-1. pip 配置 ​

创建或编辑 pip.conf（Linux/macOS）或 pip.ini（Windows）：

ini
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn

6-2. 开发工具配置 ​

  1. 代码格式化

    • 安装 black
    • 配置自动格式化

  2. 代码检查

    • 安装 pylint
    • 配置检查规则