Installing packages into ... requires administrator privileges.

0 报错信息

Installing packages into 'Python 3.9' requires administrator privileges.

Configure a per-project virtual environment as your project interpreter
to avoid installing packages to a protected area of the file system.

权限问题，通常发生在你试图在全局 Python 环境中安装包（如系统自带的 Python 或通过某些 IDE 默认配置使用了系统环境），而你的用户没有管理员权限或该路径受保护。

1 原因分析

尝试安装包到系统级 Python 环境

如 /usr/bin/python3.9（Linux）或 C:\Program Files\Python39（Windows），这些目录是只读或需要管理员权限才能写入。

IDE（如 PyCharm、VS Code）默认使用了全局解释器

导致你在项目中运行 pip install 时，会尝试将包安装到系统路径下。

2 解决方案

使用虚拟环境（Virtual Environment）。

2.1 为项目创建并使用虚拟环境

2.1.1 方法一：使用 venv 创建虚拟环境（推荐）

# 在项目根目录下创建虚拟环境
python3.9 -m venv venv

2.1.2 方法二：使用 virtualenv（功能更强大）

pip install virtualenv
virtualenv venv

3 激活虚拟环境

OS	激活命令
Windows	venv\Scripts\activate
macOS/Linux	source venv/bin/activate

激活后，终端提示符一般会变成这样：

(venv) $

再安装包：

pip install transformers

所有包都会安装到当前项目的 venv/ 目录中，无需管理员权限。

4 配置 IDE 虚拟环境

4.1 PyCharm设置项目解释器为虚拟环境

打开 PyCharm → File → Settings (Preferences on Mac)，找到 Project: <your_project_name> → Python Interpreter，点击Add Interpreter。选择：

Generate new

Existing environment

1. 浏览到你的虚拟环境目录，例如：

   • Windows: venv\Scripts\python.exe
   • macOS/Linux: venv/bin/python
2. 确认保存即可

4.2 VS Code设置解释器

1. 打开命令面板（Ctrl + Shift + P）
2. 输入并选择：Python: Select Interpreter
3. 选择你创建的虚拟环境（如 ./venv/bin/python）

5 建议

• 不用全局 Python 安装包，除非你知道自己在做啥
• 每次新建项目都创建虚拟环境
• 可用 which python / where python 查看当前用的 Python 路径

6 总结

问题	原因	解决方案
安装失败，提示需要管理员权限	正在向系统 Python 安装包	使用虚拟环境（venv/virtualenv）
如何避免此类问题	全局环境权限限制	项目级虚拟环境隔离依赖
IDE 中如何解决	默认使用系统解释器	修改项目解释器为虚拟环境路径

本文已收录在Github，关注我，紧跟本系列专栏文章，咱们下篇再续！

• 🚀 魔都架构师 | 全网30W技术追随者
• 🔧 大厂分布式系统/数据中台实战专家
• 🏆 主导交易系统百万级流量调优 & 车联网平台架构
• 🧠 AIGC应用开发先行者 | 区块链落地实践者
• 🌍 以技术驱动创新，我们的征途是改变世界！

• 👉 实战干货：编程严选网

  本文由博客一文多发平台 OpenWrite 发布！