直接用pyenv安装多python版本最安全干净，无需root权限且不干扰系统python；需先装齐编译依赖（如ubuntu执行sudo apt install相应-dev包），再正确配置pyenv_root、path及双eval初始化，最后pyenv install 3.11.9并pyenv global 3.11.9生效。
直接用 pyenv 就能装多个 Python 版本，不用动系统自带的 python，也不需要 root 权限——这是最安全、最干净的做法。
安装 pyenv 前必须装齐编译依赖
很多用户卡在 pyenv install 3.11.9 报错，根本原因是缺编译工具或头文件。Ubuntu/Debian 系统执行：
sudo apt update && sudo apt install -y make build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev xz-utils tk-dev libffi-dev liblzma-dev- CentOS/RHEL 系统用：
sudo yum groupinstall "Development Tools" && sudo yum install -y gcc openssl-devel bzip2-devel libffi-devel zlib-devel sqlite-devel readline-devel tk-devel xz-devel - 没装全就跑
pyenv install，大概率遇到configure: error: no acceptable C compiler found in $PATH或ModuleNotFoundError: No module named '_ssl'
pyenv 安装和初始化要分两步写进 shell 配置
只执行 curl https://pyenv.run | bash 不够，环境变量必须手动加对。否则 pyenv 命令能用，但 python 还是调不到 pyenv 管的版本。
A Python CLI skill for Cutout.Pro visual APIs — background removal, face cutout, and photo enhancement. Supports file upload & image URL input.
下载
调用 Cutout.Pro 视觉处理 API 进行背景移除、人像抠图和照片增强，支持文件上传与图片 URL 输入。
- 把这三行加到
~/.bashrc或~/.zshrc（别漏掉换行）：export PYENV_ROOT="$HOME/.pyenv"export PATH="$PYENV_ROOT/bin:$PATH"eval "$(pyenv init --path)"eval "$(pyenv init -)" - 然后运行
source ~/.bashrc（或source ~/.zshrc），再开个新终端验证：which python应该指向~/.pyenv/shims/python，不是/usr/bin/python - 常见错误：漏掉
eval "$(pyenv init --path)"—— 这会导致pip装的包找不到，或者python -m venv失败
安装指定版本时注意命名规范和缓存加速
pyenv install --list 输出很长，真正可安装的稳定版一般带点号（如 3.11.9），别选 3.11-dev 或 3.11.9-debug 这类非标准构建。
- 安装前先确认目标版本存在：
pyenv install --list | grep "^ *3\.11\." - 国内下载慢？把源码包手动下好扔进
~/.pyenv/cache/（目录不存在就mkdir -p ~/.pyenv/cache），比如：wget https://www.python.org/ftp/python/3.11.9/Python-3.11.9.tgz -O ~/.pyenv/cache/Python-3.11.9.tgz - 安装命令就是：
pyenv install 3.11.9，不要加python-前缀，也不要写成3.11.9.tgz - 装完用
pyenv versions看列表，刚装的版本不会自动设为全局，得自己pyenv global 3.11.9或pyenv local 3.11.9
切换版本后 python 和 pip 是配套的，但 pip 升级要小心
pyenv 切换的是整个解释器环境，python 和 pip 自动对齐，但别在 pyenv 管理的版本里执行 python -m pip install --upgrade pip 后又切版本——新旧 pip 可能不兼容。
- 推荐做法：每次切换后，先运行
python -m pip --version确认 pip 绑定正确；再按需升级：python -m pip install --upgrade pip setuptools wheel - 如果某个项目要用
pip安装 C 扩展（比如numpy），确保对应版本的python-dev包已装（Ubuntu 上是python3.11-dev） - 容易忽略的一点：
pyenv global设置的是用户级默认，但如果你在某目录下执行过pyenv local 3.8.10，那该目录及子目录会无视 global，优先用 local 版本——这个行为不可见，排查时容易漏看.python-version文件
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
