VS Code 正确运行一个 Python 项目
·
你想在 VS Code 正确运行一个 Python 项目,需要做到 4 件事:
1. 你必须知道:你到底要运行哪个文件
很多人连入口文件在哪都不确定,然后怪 VS Code 不运行。
标准做法:
- 找到
main.py或项目里真正作为入口的脚本。 - 如果项目结构是这样的:
project/
│── src/
│ └── main.py
│── requirements.txt
│── something.py
入口大概率在 main.py。
如果你连“入口在哪”都不确定,那说明你对自己的项目理解是零,需要先整理结构。
2. 你必须指定 Python 解释器
如果你跳过这步,你运行出来的大概率是系统 Python,而不是项目虚拟环境,然后一堆报错。
在 VS Code 里做:
- 按
Ctrl+Shift+P - 输入:
Python: Select Interpreter - 选择你项目所在虚拟环境,如:
.venv/bin/python
venv/Scripts/python.exe
如果你根本没创建虚拟环境,那就是你在偷懒,并且未来会被依赖冲突反噬。
3. 你必须在项目根目录打开 VS Code
如果你现在是用 VS Code “打开单个文件”,那你压根没有在“项目”里工作。
正确做法:
在终端里进入项目目录:
cd path/to/project
code .
如果你连目录结构都不重视,你跑任何项目都会混乱。
4. 你必须以明确方式运行:不要靠猜测
VS Code 给你三种方式,但你应该用明确、可控的方式。
方式 A:终端运行(最稳、最专业)
python main.py
如果你连终端都不用,那你永远不会真正学会控制 Python 项目。
方式 B:右上角运行按钮(只适合简单脚本)
打开 main.py,点右上角绿色三角按钮。
但注意:这是最低级的运行方式,它不会处理复杂项目结构。
方式 C:调试器(专业项目必须用)
- 在左侧点击“运行与调试”
- 点击“创建 launch.json”
- 选择 Python
- 配置你的入口文件,比如:
{
"name": "Run Main",
"type": "python",
"request": "launch",
"program": "${workspaceFolder}/src/main.py"
}
再点绿色 ▶ 运行。
如果你的项目比较复杂,这是唯一不出事的方式。
更多推荐

所有评论(0)