使用pybraries调用Libraries.io API时如何以编程方式设置API_KEY及环境变量配置无效问题排查

一、如何在源代码中编程式设置API密钥 #

虽然官方文档只强调了环境变量的方式，但pybraries其实支持直接在代码里设置API密钥，有两种常用方式：

方法1：实例化Search时直接传入密钥 #

from pybraries.search import Search

# 把你的实际API密钥填在这里
search = Search(api_key="your_libraries_io_api_key")
info = search.project_search(keywords='visualization', sort='stars', platform='pypi')
print(info)

方法2：全局设置API密钥（适合多次调用的场景） #

如果你的项目中需要多次创建Search实例，可以全局设置一次密钥，后续无需重复传入：

import pybraries
from pybraries.search import Search

# 全局配置密钥
pybraries.set_api_key("your_libraries_io_api_key")

# 后续实例化Search时自动使用已设置的密钥
search = Search()
info = search.project_search(keywords='visualization', sort='stars', platform='pypi')
print(info)

二、环境变量设置后不生效的排查方案 #

你提到在MBP上已设置LIBRARIES_API_KEY但仍报错，大概率是环境变量没被正确加载到当前运行环境，可按以下步骤排查：

• 确认环境变量已被当前shell会话加载：
  如果你是在~/.zshrc（Zsh）或~/.bash_profile（Bash）中添加的环境变量，需要执行source ~/.zshrc或source ~/.bash_profile让变更立即生效，或者直接重启终端窗口。

• IDE未继承系统环境变量：
  如果你用PyCharm、VS Code等IDE运行代码，IDE默认可能不会自动同步终端的环境变量。解决方法：

  • 在IDE的运行配置中手动添加LIBRARIES_API_KEY环境变量；
  • 或者从终端启动IDE（比如输入open -a PyCharm），这样IDE会自动继承终端的环境变量。

• 验证环境变量是否真的生效：
  在运行Python脚本的同一个终端里，先执行：

  echo $LIBRARIES_API_KEY
  

  确认能输出你的API密钥后，再运行Python脚本。如果终端运行正常但IDE不行，就按上面的IDE配置方法处理。

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