你想在 VS Code 正确运行一个 Python 项目,需要做到 4 件事:

1. 你必须知道:你到底要运行哪个文件

很多人连入口文件在哪都不确定,然后怪 VS Code 不运行。

标准做法:

  • 找到 main.py 或项目里真正作为入口的脚本。
  • 如果项目结构是这样的:
project/
│── src/
│     └── main.py
│── requirements.txt
│── something.py

入口大概率在 main.py

如果你连“入口在哪”都不确定,那说明你对自己的项目理解是零,需要先整理结构。


2. 你必须指定 Python 解释器

如果你跳过这步,你运行出来的大概率是系统 Python,而不是项目虚拟环境,然后一堆报错。

在 VS Code 里做:

  1. Ctrl+Shift+P
  2. 输入:Python: Select Interpreter
  3. 选择你项目所在虚拟环境,如:
.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:调试器(专业项目必须用)

  1. 在左侧点击“运行与调试”
  2. 点击“创建 launch.json”
  3. 选择 Python
  4. 配置你的入口文件,比如:
{
    "name": "Run Main",
    "type": "python",
    "request": "launch",
    "program": "${workspaceFolder}/src/main.py"
}

再点绿色 ▶ 运行。

如果你的项目比较复杂,这是唯一不出事的方式。


Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐