pip install --target 将包安装到指定绝对路径但不被python自动识别，需手动添加路径到sys.path或pythonpath；--prefix对wheel包基本无效，推荐用venv隔离环境。

pip install 默认不会装到你指定的目录，必须显式用 --target 或 --prefix 才能控制路径；但直接用 --target 安装后，Python 默认不自动识别该目录，需要手动加进 sys.path 或设环境变量。

pip install --target 指定安装目录的实际效果

这个参数会把包解压、编译（如有）、安装到你给的绝对路径下，不经过 site-packages 机制校验，也不写入 easy-install.pth。它适合离线部署或嵌入式场景，但不是“让 Python 自动认这个位置”的万能方案。

• --target 路径必须存在，且有写权限；若路径里有空格或中文，建议用引号包裹整个路径
• 安装后，pip show 包名 查不到该包 —— 因为它没注册进当前环境的包数据库
• 该目录下生成的是纯模块文件（如 numpy/、numpy-1.24.3.dist-info/），没有 .egg-link 或 .pth 文件
• 运行时要 import 这个包，得提前把目标路径加进 sys.path，例如：import sys; sys.path.insert(0, "/my/libs")

为什么 pip install --prefix 不等于“换安装位置”

--prefix 是配合 --install-layout=deb 或源码安装（setup.py install）使用的，对 wheel 包基本无效。它会尝试按类 Unix 目录结构布局（lib/python3.x/site-packages、bin/ 等），但 pip 当前版本（24.x+）在普通 install 场景下会忽略它，除非你同时传 --no-deps 和 --single-version-externally-managed —— 这已经超出日常使用范畴。

python-script-generator

快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。

下载

• 单纯执行 pip install --prefix /opt/mypkgs requests，requests 仍会落到默认 site-packages
• 真正生效的组合是：pip install --prefix /opt/mypkgs --no-deps --no-compile --force-reinstall --ignore-installed requests，但极易破坏依赖关系
• 更稳妥的做法是：用 venv 创建隔离环境，再用 pip install -t 到子目录，或改 PYTHONPATH

如何让 Python 永久识别自定义安装目录

靠改 sys.path 是临时的；长期可用的方式只有两个：设 PYTHONPATH 环境变量，或写 .pth 文件到已有 site-packages 目录中。

• Windows 下设环境变量：set PYTHONPATH=C:\mylibs;%PYTHONPATH%（命令行）或系统属性 → 环境变量中添加
• Linux/macOS：export PYTHONPATH="/home/user/mylibs:$PYTHONPATH"，写入 ~/.bashrc 或 ~/.zshrc
• 或者，在你已有的 site-packages 目录里（比如 pip show pip | grep Location 输出的路径）新建一个 mylibs.pth 文件，内容只有一行：C:\mylibs（Windows）或 /home/user/mylibs（Linux/macOS）
• .pth 文件方式要求目标路径下有合法的包结构（含 __init__.py 或 dist-info），否则 import 失败

常见错误：pip install -t 后 import 报 ModuleNotFoundError

这不是 pip 安装失败，而是 Python 解释器根本没去那个目录找。典型现象是：pip install -t ./vendor flask 成功，但 python -c "import flask" 报错。

• 检查是否误用了相对路径：-t vendor 在不同工作目录下指向不同位置，务必用绝对路径，如 -t /full/path/to/vendor
• 确认目标目录里确实生成了 flask/ 和 flask-*.dist-info/，而不是空文件夹
• 运行脚本前没设置 PYTHONPATH，也没在代码开头插入 sys.path
• 如果用 IDE（如 PyCharm），它默认只读取 interpreter 配置里的 site-packages，需手动把 vendor 目录加进项目解释器路径

最易被忽略的一点：用 --target 安装的包，如果自身有 C 扩展（如 numpy、pillow），在非标准路径下可能因找不到运行时库（.dll 或 .so）而 import 时崩溃，不是报 ModuleNotFoundError，而是 ImportError: DLL load failed 或 Symbol not found —— 这时候得连同依赖的二进制库一起挪过去，或改用 venv + pip install。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！