在 VSCode 中创建并配置 Python 项目文件是一个系统性的过程，涉及环境准备、项目初始化、关键文件创建与配置等多个环节。以下是详细的步骤和配置方法。 ### 一、 环境准备与基础配置 在创建项目之前，需要确保开发环境已正确搭建。 1. **安装 VSCode 与 Python 扩展** 首先，从官网下载并安装 VSCode。安装完成后，必须安装官方的 **Python 扩展**。该扩展提供了代码补全、智能感知、代码检查、调试等核心功能，是进行 Python 开发的基础 [ref_1][ref_4]。 2. **配置 Python 解释器** 打开 VSCode，使用快捷键 `Ctrl+Shift+P` (Windows/Linux) 或 `Cmd+Shift+P` (macOS) 打开命令面板，输入并选择 **“Python: Select Interpreter”**。 * 此操作会列出系统已安装的所有 Python 解释器。 * 建议为每个项目使用独立的虚拟环境，以避免依赖冲突 [ref_1][ref_4]。 3. **（推荐）创建 Python 虚拟环境** 虚拟环境是 Python 项目的最佳实践。可以在项目根目录下通过终端创建： ```bash # 在项目文件夹内打开终端执行 python -m venv .venv ``` 创建后，再次通过 `“Python: Select Interpreter”` 命令，选择路径为 `./.venv/Scripts/python` (Windows) 或 `./.venv/bin/python` (macOS/Linux) 的解释器 [ref_4][ref_5]。 ### 二、 创建 Python 项目文件与结构 一个典型的 Python 项目包含源代码、配置文件和文档等。以下是创建核心文件的步骤。 1. **创建项目工作区** 在本地文件系统中创建一个空文件夹作为项目根目录，例如 `my_python_project`。然后，在 VSCode 中通过 `文件 -> 打开文件夹` 打开此目录，这便建立了项目的工作区 [ref_2]。 2. **创建核心 Python 文件** 在 VSCode 的资源管理器侧边栏中，右键点击项目文件夹，选择“新建文件”。通常，一个项目至少包含一个入口文件。 * **主程序文件**：例如 `main.py` 或 `app.py`。这是程序的执行起点。 * **模块文件**：根据功能划分，创建如 `utils.py`、`models.py` 等模块文件 [ref_1]。 一个简单的 `main.py` 示例： ```python # main.py - 项目入口文件 def greet(name): """一个简单的问候函数""" return f"Hello, {name}!" if __name__ == "__main__": # 程序主逻辑 user = "World" print(greet(user)) ``` 3. **创建项目配置文件** 为了管理项目依赖和开发配置，需要创建以下关键文件： | 文件名称 | 主要用途 | 内容示例 | | :--- | :--- | :--- | | `requirements.txt` | 记录项目运行所需的所有第三方库及其版本。 | `flask>=2.0.0` <br> `requests==2.28.0` <br> `pandas` | | `pyproject.toml` (现代) | 替代 `setup.py`，用于声明项目元数据、构建系统和依赖。更推荐用于新项目。 | `[project]` <br> `name = “my-project”` <br> `dependencies = [“flask>=2.0.0”]` | | `.gitignore` | 指定哪些文件或目录应被 Git 版本控制系统忽略。 | `__pycache__/` <br> `*.pyc` <br> `.venv/` <br> `.env` | ### 三、 配置 VSCode 以优化开发体验 通过配置 VSCode 的设置和调试文件，可以极大提升开发效率。 1. **配置工作区设置 (`.vscode/settings.json`)** 在项目根目录下创建 `.vscode` 文件夹，并在其中创建 `settings.json` 文件。这个文件用于覆盖针对本项目的编辑器设置 [ref_2]。 ```json { // 指定 Python 解释器路径，确保团队统一环境 “python.defaultInterpreterPath”: “${workspaceFolder}/.venv/Scripts/python.exe”, // 保存时自动格式化代码 “editor.formatOnSave”: true, // 为 Python 文件指定格式化工具，如 autopep8 或 black “[python]”: { “editor.defaultFormatter”: “ms-python.autopep8” }, // 启用代码检查 “python.linting.enabled”: true, // 关闭 Git 自动刷新以提升大项目性能 [ref_5] “git.autorefresh”: false } ``` 2. **配置调试功能 (`.vscode/launch.json`)** 对于需要调试的项目（如 Flask Web 应用），配置调试器至关重要 [ref_3]。在 `.vscode` 文件夹中创建 `launch.json` 文件。 ```json { “version”: “0.2.0”, “configurations”: [ { “name”: “Python: 启动当前文件”, “type”: “python”, “request”: “launch”, “program”: “${file}”, // 调试当前打开的文件 “console”: “integratedTerminal”, “justMyCode”: true }, { “name”: “Python: Flask 调试”, “type”: “python”, “request”: “launch”, “module”: “flask”, // 指定运行 Flask 模块 “env”: { “FLASK_APP”: “app.py”, // 指定 Flask 应用入口 “FLASK_ENV”: “development” }, “args”: [ “run”, “--no-debugger”, “--no-reload” ], “jinja”: true } ] } ``` 配置完成后，在 `main.py` 或 `app.py` 中设置断点，按 `F5` 即可启动调试 [ref_3][ref_6]。 ### 四、 运行与测试项目 完成上述配置后，即可在 VSCode 中方便地运行和测试代码。 1. **在集成终端中运行** 使用快捷键 `` Ctrl+` `` 打开 VSCode 的集成终端，确保终端已激活项目的虚拟环境（路径前应有 `(.venv)` 提示）。然后直接运行 Python 脚本： ```bash (.venv) python main.py ``` 2. **使用运行按钮** 在打开的 Python 文件右上角，会出现一个三角形的“运行”按钮。点击它，VSCode 会使用当前选择的解释器直接运行该文件，并在终端输出结果 [ref_1]。 3. **安装依赖并运行复杂项目** 如果项目有 `requirements.txt`，首先在终端安装依赖： ```bash (.venv) pip install -r requirements.txt ``` 对于像 TensorFlow 这样的特定库，确保选择与库版本匹配的 Python 解释器 [ref_6]。之后，即可运行主程序或使用配置好的调试模式启动项目。