python 配置

简介

记录一下 python 的配置.

安装

普通安装

• 搜索 winget search python
• 安装 winget install Python.Python.3.13
• 安装 pipx py -m pip install --user pipx
• 配置 pipx py -m pipx ensurepath

新工具安装

• winget install --id=astral-sh.uv -e

配置源

• 运行完命令, 会显示配置文件路径
  • pip config set global.index-url http://mirrors.aliyun.com/pypi/simple/
  • pip config set global.trusted-host mirrors.aliyun.com

效果如下

[global]
index-url = http://mirrors.aliyun.com/pypi/simple/
trusted-host = mirrors.aliyun.com

新工具

• Astral · GitHub
  • uv 会取代 rye. 但是现阶段 rye 更好用
  • 这个机构下面还有 ruff 用于 lint 格式化
• PDM README_zh.md
• Poetry Introduction | Documentation | Poetry - Python dependency management and packaging made easy

uv

安装

1. 下载二进制文件 Releases · astral-sh/uv 到 /usr/local/bin/
2. 配置镜像源到 ~/.bashrc

export UV_DEFAULT_INDEX=https://mirrors.aliyun.com/pypi/simple/
export UV_PYTHON_INSTALL_MIRROR=https://gh-proxy.com/https://github.com/astral-sh/python-build-standalone/releases/download

使用

• 命令工具
  • uv tool 可以用来代替 pipx:
  • 添加 $PATH 路径 export PATH="/root/.local/bin:$PATH"
  • 安装 uv tool install ansible-core
  • 常用命令 uv tool upgrade/uninstall/list , 查看安装路径 uv tool dir
• 安装 python
  • 最新版本 uv python install
  • uv python install 3.10 特定版本
  • uv python list 查看所有的版本, 包括系统自带的
• 运行脚本
  • uv run 1.py 运行脚本
• 项目

  • uv init hi : 会创建项目文件夹, 锁定 python 版本

  • uv init --python 3.10 在项目里锁定特定 python 版本

  • pyproject.toml 添加镜像源

    toml

    [tool.uv]
    python-install-mirror = "https://gh-proxy.com/https://github.com/astral-sh/python-build-standalone/releases/download"
    
    [[tool.uv.index]]
    url = "https://mirrors.aliyun.com/pypi/simple/"
    default = true

  • uv add requests: 创建 .venv 环境, 锁包 uv.lock

  • 项目锁定版本号，同时修改 .python-version 为 3.13.7 ，pyproject.toml 的 requires-python = "==3.13.7"

项目初始化

fastapi

mkdir fastapi-demo && cd fastapi-demo

uv add fastapi uvicorn
# 开发命令
import uvicorn
uvicorn.run("main:app", host="0.0.0.0", port=8000, log_level="info",reload=True)
# 生产环境
uvicorn main:app --host 0.0.0.0 --port 8080 --workers 4