VS Code和PyCharm中怎么运行Python项目
详细讲解在VS Code和PyCharm两大主流开发工具中打开、配置解释器、运行与调试Python项目的具体步骤、原理和排错要点。
运行一个 Python 项目的核心只有两件事：用正确的 Python 解释器环境解析代码，以及指定正确的入口文件来启动进程。无论是轻量级的 VS Code 还是专为 Python 打造的 PyCharm，所有操作逻辑都围绕“识别项目目录、绑定运行环境、指定入口执行”展开。本文将直接带你掌握两款工具中运行单文件脚本与多文件模块项目的具体方法、排错路径及核心差异。
一、运行 Python 项目的通用底层逻辑
在深入具体工具之前，理解编辑器背后的执行模型可以避免大部分“为什么找不到模块”或“明明安装了库却报错”的问题。代码本身只是静态文本，它必须由一个具体的 python 可执行文件来逐行读取和解析。
每一个 Python 项目通常对应一个独立的运行环境（例如项目的虚拟环境 .venv 或系统全局 Python）。当你在编辑器中点击“运行”按钮时，编辑器本质上是在终端里敲下一行带参数的启动命令，并把当前工作目录切换到项目根目录下。如果编辑器绑定的解释器没有安装依赖包，或者入口文件不在工作目录的查找路径中，程序就会中断。
二、在 Visual Studio Code 中运行 Python 项目
VS Code 本质是一个代码编辑器，它通过插件体系获得类似 IDE 的能力。在 VS Code 中运行项目，必须先确保安装了微软官方提供的 Python 扩展扩展包。
1. 打开项目工作区
切忌直接单开一个 .py 文件。请在顶部菜单栏选择 文件 -> 打开文件夹（File -> Open Folder），直接选中项目的顶层目录。这样做能让 VS Code 将该目录作为项目的根目录（Workspace Root），在后续模块寻址时自动基于根目录定位。
2. 选择或切换解释器
项目打开后，VS Code 需要明确该使用哪个 Python 解释器执行代码：
- 使用快捷键
Ctrl + Shift + P（macOS 为Cmd + Shift + P）打开命令面板。 - 输入并选择
Python: Select Interpreter。 - 在列表中会显示系统已检测到的 Python 解释器、Conda 环境或项目内的虚拟环境（如
.venv/Scripts/python.exe）。选择带有项目推荐标签或对应依赖环境的那一项。
3. 直接运行与调试运行
在左侧资源管理器中点击你的入口文件（例如 main.py）：
- 常规运行：点击编辑器右上角的三角形播放图标，或右键选择“在终端中运行 Python 文件”。下方会调出内置终端并打印运行输出。
- 断点调试：在代码行号左侧单击添加红点（断点），按
F5启动调试。若项目第一次调试，选择“Python File (Debug the currently active Python file)”。程序会在断点处暂停，方便查看局部变量和调用堆栈。
4. 多文件与带参数运行：配置 launch.json
如果项目包含复杂的启动参数，或者启动时需要特定的工作目录环境变量，单靠右上角按钮往往无法满足需求。此时应当配置 launch.json：
切换到左侧“运行与调试”面板，点击“创建 launch.json 文件”，并在项目根目录下的 .vscode/launch.json 中定义配置：
{
"version": "0.2.0",
"configurations": [
{
"name": "Python: 运行项目入口",
"type": "debugpy",
"request": "launch",
"program": "${workspaceFolder}/main.py",
"console": "integratedTerminal",
"cwd": "${workspaceFolder}",
"args": ["--mode", "dev", "--port", "8000"]
}
]
}配置中的 cwd（Current Working Directory）确保了无论你在编辑器里正看着哪个文件，按 F5 时始终以项目根目录为基准启动 main.py。
三、在 PyCharm 中运行 Python 项目
PyCharm 是专为 Python 开发设立的集成开发环境。相比 VS Code，PyCharm 对虚拟环境检测、代码索引及“运行/调试配置”（Run/Debug Configurations）进行了强约束与集中管理。
1. 导入或新建项目
在欢迎界面点击 Open（打开），选中项目文件夹。PyCharm 会扫描当前目录，并在后台建立代码索引。如果根目录下存在 requirements.txt 或 Pipfile，PyCharm 通常会弹出提示，询问是否为该项目创建对应的虚拟环境。
2. 检查与设置 Python 解释器
如果项目已有虚拟环境，或者需要指定已有的 Python 路径：
- 点击右下角状态栏的解释器标识，或进入 Settings -> Project: [项目名称] -> Python Interpreter（macOS 为
Preferences）。 - 点击 Add Interpreter（添加解释器），选择 Add Local Interpreter。
- 如果使用项目自带的虚拟环境，选择 Existing，并指定到对应目录下的
python.exe（Windows）或bin/python（macOS/Linux）；若需要新建，可选择 Virtualenv Environment -> New。
3. 运行与配置管理（Run/Debug Configuration）
最快捷的启动方式是：在项目文件树中找到启动入口（如 main.py），单击鼠标右键，选择 Run 'main'。此时控制台窗口会从底部升起，展示执行过程。
这一步完成后，PyCharm 会自动在右上角工具栏为你保留名为 main 的执行配置。后续你可以随时点击右上角的绿色三角符号（Run）或小虫子符号（Debug）。若需添加参数：
- 点击右上角运行下拉框中的 Edit Configurations...。
- 在 Parameters 输入框中填入附加参数（如
--host 0.0.0.0）。 - 确认 Working directory 是否为项目的根路径。保持 Working directory 正确是避免模块导入失败的关键。
四、两款工具运行方式对比与选择依据
理解工具之间的侧重差异，有助于你在面对不同规模的项目时快速做出选择：
| 对比维度 | Visual Studio Code | PyCharm (Community / Professional) |
|---|---|---|
| 核心定位 | 通用轻量编辑器，依靠插件支持语言 | 专精 Python 开发的全功能 IDE |
| 环境识别方式 | 通过命令面板手动选定解释器路径 | 强绑定 Project Interpreter，导入时主动扫描 |
| 运行配置存储 | .vscode/launch.json（纯 JSON 文本） |
.idea/runConfigurations/（IDE 自带配置界面） |
| 工作目录处理 | 默认为打开的顶层文件夹，支持手动指定 | 默认严格按项目根路径设定，支持将子目录设为 Sources Root |
| 适用场景 | 单文件脚本、跨语言工程、轻量级脚本任务 | 大中型多模块框架项目（如 Django、FastAPI） |
五、常见问题排查与注意事项
这是在两款工具中运行多文件 Python 项目最常遇到的报错。根本原因在于：Python 的模块搜索路径 sys.path 中没有包含你要引用的目录。
- 在 VS Code 中：请确保你是通过“打开文件夹”载入了包含包名的最外层目录，而不是直接在 VS Code 里单独打开了深层子文件夹下的某个
.py文件。 - 在 PyCharm 中：如果自定义模块位于特定文件夹（例如
src目录下），请在项目视图中右键该目录，选择 Mark Directory as -> Sources Root。PyCharm 会将其自动加入PYTHONPATH。
很多初学者在 VS Code 自带的终端里执行 pip install requests，但运行时仍然报错提示 No module named 'requests'。这是因为终端使用的 Python 与编辑器当前选中的解释器不是同一个。
解决方法：在终端中输入 which python（Linux/macOS）或 where python（Windows），比对输出的路径是否与状态栏/解释器配置面板上显示的目标路径完全一致。
六、总结
在 VS Code 和 PyCharm 中运行 Python 项目，界面布局与交互形式各有侧重，但解决问题的技术脉络完全统一：
- 项目载入：始终以项目的最外层目录作为文件夹或工程导入，确保工作路径基准正确。
- 环境绑定：找到并核验工具中当前正在使用的 Python 解释器，确保运行环境已安装代码所需的第三方包。
- 执行与调试：简单脚本直接通过右键或界面按钮运行；涉及复杂参数、自定义路径或多模块协同的工程，通过
launch.json（VS Code）或Run/Debug Configurations（PyCharm）固化启动配置。
只要按这三步规范设置，无论更换哪款工具，你都能准确、稳定地运行和调试 Python 项目。
免责声明：本文内容仅供参考，不代表本站观点。转载或引用请注明出处。
