Ubuntu系统下LibreOffice宏导入gspread的安装问题咨询

系统信息 #

Distributor ID: Ubuntu
Description:    Ubuntu 23.04
Release:    23.04
Codename:   lunar
LibreOffice 7.5.5.2 50(Build:2)

geany 1.38 (built on 2021-10-14 with GTK 3.24.30, GLib 2.68.4)
Python 3.11.4

问题场景 #

尝试在LibreOffice宏中导入gspread，执行命令~$ pip install gspread --user --upgrade时触发外部管理环境错误，错误信息如下：

~$ pip install gspread --user --upgrade
error: externally-managed-environment

× This environment is externally managed
╰─> To install Python packages system-wide, try apt install
python3-xyz, where xyz is the package you are trying to
install.

If you wish to install a non-Debian-packaged Python package,
create a virtual environment using python3 -m venv path/to/venv.
Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make
sure you have python3-full installed.

If you wish to install a non-Debian packaged Python application,
it may be easiest to use pipx install xyz, which will manage a
virtual environment for you. Make sure you have pipx installed.

See /usr/share/doc/python3.11/README.venv for more information.

note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages.
hint: See PEP 668 for the detailed specification.

核心疑问：

• 接下来该如何操作？
• 是否可以直接将tarball放入/usr/lib/libreoffice/share/Scripts/Python目录而不破坏系统？

解决方案与说明 #

关于直接放入tarball的风险 #

绝对不建议这么做。该目录属于系统级权限路径，手动解压tarball会导致权限混乱，后续系统更新时文件可能被覆盖，且无法自动处理gspread的依赖包，后续维护难度极高，极易引发未知问题。

推荐方案 #

方案一：给LibreOffice专属Python环境安装gspread

LibreOffice自带独立Python解释器，需用它对应的pip工具安装：

1. 定位LibreOffice的Python路径：

   find /usr/lib/libreoffice -name python3
   

   通常路径为/usr/lib/libreoffice/program/python3
2. 用该Python执行pip安装：

   /usr/lib/libreoffice/program/python3 -m pip install gspread --user
   

   --user参数会将包安装到你的用户目录，完全避开系统环境限制，不会影响系统稳定性。

方案二：创建虚拟环境并让LibreOffice加载

1. 创建并配置虚拟环境：

   # 创建虚拟环境到用户目录
   python3 -m venv ~/lo-gspread-venv
   # 激活并安装gspread
   source ~/lo-gspread-venv/bin/activate
   pip install gspread
   deactivate
   

2. 配置LibreOffice加载虚拟环境：
   • 打开LibreOffice，依次点击「工具」→「选项」→「LibreOffice」→「高级」→「Python脚本设置」
   • 在「Python路径」中添加虚拟环境的site-packages目录，路径示例：~/lo-gspread-venv/lib/python3.11/site-packages
   • 重启LibreOffice后，宏即可识别gspread模块。

方案三：使用系统包（若存在）

先检查Ubuntu是否提供gspread的deb包：

apt search python3-gspread

如果搜索到结果，直接用系统包管理器安装：

sudo apt install python3-gspread

这种方式最安全，完全符合系统环境管理规范，但如果没有对应deb包则需使用前两种方案。

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