pip install git+https://github.com/huggingface/peft.git 可直接安装远程仓库，无需克隆或进入目录，要求仓库含 setup.py 或 pyproject.toml；指定分支或标签需添加 @ 后缀，如 @v0.10.0。
直接用 pip install git+ 安装远程仓库
不用克隆、不用进目录，一行命令就能装 GitHub / GitLab 上的代码，前提是目标仓库有合法的 setup.py 或 pyproject.toml。
常见写法：
-
pip install git+https://github.com/huggingface/peft.git—— 默认装main分支 -
pip install git+https://github.com/huggingface/peft.git@v0.10.0—— 指定 tag -
pip install git+https://github.com/huggingface/peft.git@dev—— 指定分支名 -
pip install git+ssh://git@github.com/Me1onRind/foo.git@test—— 用 SSH 协议（需配好密钥）
注意：git+ 后必须是完整可访问的 Git URL，不能是网页地址（比如 https://github.com/xxx/yyy 不行，必须带 .git 后缀）。
本地已有仓库时用 pip install .
适合调试、改源码、或网络受限但已手动下载好代码的情况。
操作步骤很直白：
- 确保当前目录下存在
setup.py或pyproject.toml - 运行
pip install .（结尾的点不能少） - 如果想边改边用，换成
pip install -e .（-e表示 editable 模式，修改代码后无需重装）
容易踩的坑：python setup.py install 看似等价，但可能绕过 pip 的依赖解析逻辑，导致 install_requires 里的包没装全；优先用 pip install .。
GitHub Hosts CN
下载
GitHub Hosts 更新工具（仅限中国用户），安全更新系统hosts文件，保留原有非GitHub条目，仅替换GitHub相关地址。支持备份恢复和风险提示。用于解决GitHub访问问题。
离线环境怎么装？关键在 --find-links 和 --no-index
内网机器、无外网权限时，不能走在线安装。得提前在外网机上把 wheel 包和所有依赖全下下来。
分两步走：
- 外网机执行：
pip download -d ./wheels GitPython（会递归下载GitPython及其全部依赖 wheel 文件） - 把整个
wheels/文件夹拷到内网机，再运行：pip install --no-index --find-links ./wheels/ GitPython
注意：--find-links 路径必须是本地绝对或相对路径，不能是 URL；且 --no-index 必须带上，否则 pip 还是会去 PyPI 查源。
为什么装完 import 不了？检查这三处
常见现象：命令行显示 Successfully installed xxx，但 Python 里 import xxx 报 ModuleNotFoundError。
大概率是以下某个问题：
- 当前 Python 环境和 pip 不一致 —— 用
which pip和which python（Linux/macOS）或where pip/where python（Windows）确认是否匹配 - 装的是 editable 模式（
-e），但没在项目根目录下运行 Python ——pip install -e .只对当前 shell 有效，且要求 Python 工作目录能识别该包结构 - 仓库没正确声明包名 —— 检查
setup.py里name=字段和你import时用的名字是否一致（比如name='gitcode'，就得import gitcode，不是import gitcode_cli）
最省事的验证方式：装完立刻跑 pip show 你的包名，看输出的 Location: 是否在当前 Python 的 site-packages 路径里。
