如何在只读文件系统下修改pip构建目录以完成本地安装？

核心原因 #

报错是因为setup.py默认会在当前代码仓库目录创建build文件夹用于编译，但仓库处于只读文件系统无法写入，导致操作失败。

可行解决方案 #

方法1：指定临时build目录到主目录 #

使用pip install的--build参数，将编译目录指定到主目录下的可写文件夹，先确保目标目录存在：

mkdir -p ~/tmp_pip_build
pip install . --user --build ~/tmp_pip_build

--user参数会确保包安装到主目录的~/.local/lib/pythonX.X/site-packages路径下，无需系统权限。

方法2：通过环境变量指定临时目录 #

设置TMPDIR环境变量指向主目录的可写路径，让编译过程自动使用该目录：

mkdir -p ~/tmp_pip_build
export TMPDIR=~/tmp_pip_build
pip install . --user

方法3：复制代码到主目录后安装 #

直接将只读仓库内的代码复制到主目录的可写文件夹，再执行安装：

cp -r /path/to/readonly/repo ~/my_local_repo
cd ~/my_local_repo
pip install . --user

这样编译操作会在主目录的副本中进行，完全避开只读限制。

注意事项 #

• 若使用--build参数，无需手动清理指定目录，pip会自动管理缓存；若遇异常，可删除该目录后重试。
• 始终加上--user参数，既能满足安装到主目录的需求，也能避免系统级权限问题。

内容的提问来源于stack exchange，提问作者anon