Ubuntu 共享目录中 uv add 创建虚拟环境失败怎么办？

结论

从描述来看，项目位于 Windows 与 VirtualBox Ubuntu 之间的共享挂载目录，而该目录不支持 uv 创建虚拟环境所需的 Python 可执行文件符号链接。将项目移到 Ubuntu 自己的 Linux 文件系统后，uv add 已能正常运行。这个现象不能说明当前用户是 root，也不表示 uv 必须以 root 权限运行。

为什么 --link-mode copy 没有解决

uv add --link-mode copy flask requests 中的 --link-mode copy 控制的是安装包从缓存复制到环境的方式。报错中的失败操作则是 uv 正在将 Python 解释器链接到项目的 .venv/bin/python。

第一次报错的关键部分是：

failed to symlink file from .../python3.11 to .../new_app/.venv/bin/python: Operation not permitted

随后出现的“不是有效的 Python 环境”提示，与前一步创建 .venv 未完成相符。再次运行时，uv 找到了这个不完整的目录，但里面没有可用的 Python 可执行文件。

处理步骤

1. 确认项目是否位于 VirtualBox 的 Windows 共享目录中。根据问题中的结果，将项目移出该挂载目录后，uv add 可以成功运行。

2. 将项目放到 Ubuntu 自己的文件系统目录中，例如 ~/projects/new_app，然后在该位置执行添加命令：

   mkdir -p ~/projects
   cd ~/projects
   uv init new_app
   cd new_app
   uv add flask requests

3. 如果原项目中的 .venv 是这次失败时留下的残缺环境，先确认里面没有需要保留的文件，再删除该目录并重新执行 uv add：

   rm -rf .venv
   uv add flask requests

   rm -rf .venv 会删除整个 .venv。执行前请确认当前目录和目标目录无误。

如果项目文件必须放在共享目录，可以尝试将虚拟环境单独放到 Ubuntu 本地文件系统，并确认当前使用的 uv 配置支持指定虚拟环境位置。具体配置方式需要根据所用版本确认。最直接的处理方式是让项目和 .venv 都位于 Linux 本地文件系统。

注意事项

错误发生在创建 .venv/bin/python 时，因此更换项目目录可以针对当前错误进行处理。单独将包安装的 link mode 改为 copy，无法保证跳过解释器链接这一步。调整 VirtualBox 共享目录的挂载或符号链接设置是否有效，取决于具体的共享方式；现有信息不足以确定适用的设置。

备注：内容仅供参考。