PYTHONPATH变量使用

更新时间：2025-06-06 GMT+08:00

查看PDF

PYTHONPATH环境变量指定了Python解释器应该查找模块的额外位置。在CodeArts IDE中，“PYTHONPATH”可以通过终端设置（“terminal.integrated.env.*”）、“.env”文件或者同时使用这两种方法来设置。

当使用终端设置时，“PYTHONPATH”会影响在终端中运行的任何工具，以及CodeArts IDE通过终端执行的如调试等的任何操作。然而，如果CodeArts IDE执行的操作不是通过终端进行的，比如使用linter或格式化器时，这个设置将不会影响模块的查找。
当使用“.env”文件设置“PYTHONPATH”时，它会影响CodeArts IDE代表您执行的所有操作以及调试器执行的操作，但不会影响在终端中运行的工具。

一个使用“PYTHONPATH”的例子是，如果您有一个包含源代码的“src”文件夹和一个包含测试的“tests”文件夹。在运行测试时，这些测试通常无法访问“src”中的模块，除非您硬编码相对路径。

为了解决这个问题，您可以在CodeArts IDE工作区内创建一个“.env”文件，并将“src”的路径添加到“PYTHONPATH”中。

PYTHONPATH=src

然后在“settings.json” 文件中设置 “python.envFile” ，指向您刚刚创建的“.env” 文件。如果“.env” 文件位于项目根目录下，则“settings.json” 应设置如下：

"python.envFile": "${workspaceFolder}/.env"

PYTHONPATH的值可以包含由“os.pathsep” 分隔的多个位置：Windows上为分号（“;”），Linux 上为冒号（“:”）。无效路径将被忽略。如果您发现 PYTHONPATH的值未按预期工作，请确保在操作系统的位置间使用正确的分隔符。在Windows上使用冒号分隔位置，或在Linux上使用分号分隔位置会导致 PYTHONPATH值无效，该值将被忽略。