Kaggle离线竞赛安装sentence-transformers遇只读文件系统错误求助

问题核心 #

安装时出现error: could not create 'build': Read-only file system，本质是pip默认的临时构建目录处于只读分区，无法写入文件；setuptools的版本警告只是提示信息，并非导致安装失败的核心原因。

可行解决办法 #

• 指定可写的构建目录：在安装命令中添加--build-dir参数，指向Kaggle允许写入的路径（比如/kaggle/working/下的临时文件夹）：

  pip install ./sentence-transformers --build-dir /kaggle/working/temp_build
  

  无需手动创建temp_build目录，pip会自动生成。

• 跳过隔离构建环境：使用--no-build-isolation参数，让pip直接在当前环境中构建，避免创建临时隔离目录：

  pip install ./sentence-transformers --no-build-isolation
  

  注意：必须确保所有依赖包已经提前安装完成，否则会因缺少依赖导致构建失败。

• 本地预构建wheel包上传安装：在本地有网络环境下提前生成sentence-transformers的wheel文件，上传到Kaggle后直接安装：

  1. 本地执行命令生成wheel：

     pip wheel sentence-transformers -w ./wheels
     

  2. 将生成的.whl文件上传到Kaggle工作目录，执行安装：

     pip install ./sentence-transformers-*.whl
     

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