Windows下Python脚本调用pip安装虚拟环境包时触发PermissionError

为什么仅在Python脚本内调用时出现权限错误？ #

核心原因有两点：

1. 目标模块文件被当前Python进程锁定：Windows系统下，若你的脚本已经导入了controller_module，对应的.pyd文件会被当前Python进程占用并锁定。当pip执行--upgrade操作时，需要删除旧的.pyd文件，但由于文件被锁定，系统会返回权限拒绝错误。而直接在shell中执行时，没有任何进程占用该文件，因此可以正常操作。
2. pip路径可能未指向虚拟环境的pip：虽然脚本运行在虚拟环境中，但subprocess.run调用的pip可能是系统全局的pip，导致写入虚拟环境目录时出现权限不足（不过从错误日志的路径来看，pip来自虚拟环境，这个可能性较低，但仍需排查）。

解决方法 #

1. 避免当前进程加载目标模块 #

在调用install_package函数前，确保没有导入controller_module。如果必须导入，可以将安装逻辑拆分到独立脚本中，主脚本通过子进程调用该独立脚本，避免模块锁定问题。例如：
独立安装脚本install_script.py：

import subprocess
import os

def main(package_path, venv_dir):
    pip_path = os.path.join(venv_dir, "Scripts", "pip.exe")
    command = [pip_path, "install", "--target", venv_dir, "--use-feature=in-tree-build", "--upgrade", "--no-clean", package_path]
    try:
        subprocess.run(command, check=True)
        print(f"Package successfully installed into virtual environment: {venv_dir}")
    except subprocess.CalledProcessError as error:
        print(f"Error installing package: {error}")

if __name__ == "__main__":
    import sys
    main(sys.argv[1], sys.argv[2])

主脚本中调用：

import subprocess
import sys

subprocess.run([sys.executable, "install_script.py", package_path, venv_dir], check=True)

2. 显式使用虚拟环境的pip路径 #

修改install_package函数，使用虚拟环境内pip的完整路径，避免调用全局pip：

def install_package(self, package_path, venv_dir):
    """
    Installs a Python package from the given path into a virtual environment.

    Args:
        package_path (str): The path to the directory containing the package to install.
        venv_dir (str): The directory path of the virtual environment.
    """
    # 使用虚拟环境内的pip路径
    pip_path = os.path.join(venv_dir, "Scripts", "pip.exe")
    command = [pip_path, "install", "--target", venv_dir, "--use-feature=in-tree-build", "--upgrade", "--no-clean", package_path]

    try:
        subprocess.run(command, check=True)
        print(f"Package successfully installed into virtual environment: {venv_dir}")
    except subprocess.CalledProcessError as error:
        print(f"Error installing package: {error}")

3. 移除--upgrade参数（非强制升级场景） #

如果不需要强制升级已安装的包，可以去掉--upgrade标志，这样pip不会尝试删除旧的.pyd文件，从而避免锁定导致的权限错误：

command = [pip_path, "install", "--target", venv_dir, "--use-feature=in-tree-build", "--no-clean", package_path]

4. 尝试释放模块锁（可靠性较低） #

如果模块已被加载，可以尝试删除模块引用并触发垃圾回收，但Windows下不一定能立即释放文件锁，仅作为临时 workaround：

import sys
import gc

# 移除模块引用
del sys.modules['controller_module']
# 强制垃圾回收
gc.collect()
# 再调用install_package
self.install_package(package_path, venv_dir)

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