VSCode 配置与 Python 开发环境搭建指南

4.1 创建虚拟环境

建议在项目目录下创建独立的虚拟环境，避免全局污染。

# 在项目根目录执行
python -m venv venv

激活虚拟环境后，VSCode 会自动识别该环境下的解释器。

• Windows: venv\Scripts\activate.bat
• Linux/Mac: source venv/bin/activate

![图片：解释器选择界面]

5. 创建项目与编写代码

5.1 初始化项目结构

良好的项目结构有助于维护。推荐结构如下：

project_name/
├── src/
│   └── main.py
├── tests/
├── venv/
├── .gitignore
└── README.md

5.2 新建文件

1. 在资源管理器中右键点击文件夹，选择 New File。
2. 命名为 main.py，确保后缀为 .py。
3. 输入以下示例代码：

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

def greet(name):
    """简单的问候函数"""
    return f"Hello, {name}!"

if __name__ == "__main__":
    user = input("请输入你的名字：")
    print(greet(user))

![图片：代码编辑界面]

6. 运行与调试

6.1 运行代码

VSCode 提供了多种运行方式：

1. 右上角绿色三角按钮：直接运行当前文件。
2. 右键菜单：选择 Run Python File in Terminal。
3. 命令面板：输入 Python: Run Current File。

运行结果将显示在底部的 Terminal 面板中。

6.2 断点调试

VSCode 内置了强大的调试功能。

1. 在代码行号左侧点击，设置红色断点。
2. 点击左侧活动栏的 Run and Debug 图标（或按 F5）。
3. 选择 Python File 配置。
4. 调试过程中可查看变量值、调用堆栈，并单步执行（Step Over, Step Into）。

![图片：调试控制台]

7. 推荐扩展插件

提升开发效率的必备扩展：

8. 常见问题排查

8.1 无法找到解释器

• 检查环境变量 PATH 是否包含 Python 路径。
• 在 VSCode 设置中手动指定 python.defaultInterpreterPath。

8.2 中文乱码问题

• 确保文件编码为 UTF-8。
• 在 settings.json 中添加：

"files.encoding": "utf8"

8.3 模块导入错误

• 确认虚拟环境已激活。
• 使用 pip install <package> 安装缺失的库。

9. 最佳实践建议

1. 使用 Linter：开启 Pylint 或 Flake8 实时检查代码质量。
2. 版本控制：及时提交代码到 Git，忽略 venv 和 __pycache__。
3. 文档化：为复杂函数添加 Docstring，方便后续维护。
4. 定期更新：保持 VSCode 和 Python 插件为最新版本。

通过上述步骤，您可以构建一个专业、高效且稳定的 Python 开发环境。VSCode 的灵活性与 Python 的易用性相结合，将为您的编程工作带来显著提升。