VSCode与树莓派开发平台搭建完全指南

树莓派作为一款功能强大的单板计算机，搭配VSCode这一现代化的轻量级编辑器，可以打造出高效的开发环境。本指南将详细介绍如何从零开始搭建VSCode与树莓派的开发平台，适合初学者和有经验的开发者参考。

一、准备工作

1.1 硬件准备

  • 树莓派（建议Raspberry Pi 4，至少2GB RAM）
  • SD卡（至少8GB，建议16GB以上，Class 10或更高速）
  • 电源适配器（官方推荐使用5V/3A USB-C电源）
  • 微型HDMI线（仅树莓派4需要）
  • USB键盘和鼠标
  • 显示器
  • 网线或支持Wi-Fi的环境
  • 读卡器（用于烧录系统）

1.2 软件准备

  • Raspberry Pi OS镜像（可从官网下载）
  • Raspberry Pi Imager（用于烧录系统）
  • Visual Studio Code（官网下载）
  • 必要的VSCode扩展

二、树莓派系统安装与基础配置

2.1 安装Raspberry Pi OS

  1. 下载并安装Raspberry Pi Imager：

  2. 烧录系统：

    • 将SD卡插入电脑
    • 在Raspberry Pi Imager中点击"选择操作系统"
    • 建议选择"Raspberry Pi OS (32-bit)"或"Raspberry Pi OS (64-bit)"完整版
    • 点击"选择存储卡"并选择您的SD卡
    • 点击"写入"按钮开始烧录

  3. 高级选项设置（推荐）：

    • 在点击"写入"前，按下Ctrl+Shift+X打开高级选项
    • 设置主机名（如raspberrypi）
    • 启用SSH并设置用户名和密码
    • 配置Wi-Fi（如需要）
    • 设置区域设置
    • 点击"保存"后再进行写入

2.2 首次启动与基础配置

  1. 连接硬件：

    • 将烧录好的SD卡插入树莓派
    • 连接显示器、键盘、鼠标
    • 连接网线或确保Wi-Fi可用
    • 最后连接电源启动树莓派

  2. 初始设置：

    • 如果使用高级选项预设，系统会自动完成设置
    • 否则，按照屏幕向导进行设置：
      • 设置国家和时区
      • 创建用户名和密码
      • 配置Wi-Fi
      • 更新系统软件

  3. 更新系统：

    sudo apt update
sudo apt full-upgrade -y

  4. 启用必要服务：

    • 如果尚未启用SSH，运行： 

      sudo raspi-config
    • 选择"接口选项" > "SSH" > "是"
    • 还可以启用VNC、SPI、I2C等根据项目需要的接口

  5. 记录树莓派IP地址：

    hostname -I

    记下输出的IP地址，用于后续远程连接。

三、在PC上设置VSCode

3.1 安装Visual Studio Code

  1. 访问VSCode官网下载适合您操作系统的版本
  2. 按照安装向导完成安装

3.2 安装必要扩展

打开VSCode，按Ctrl+Shift+X打开扩展视图，搜索并安装以下扩展：

  1. Remote - SSH：用于远程连接树莓派
  2. Python：Python开发支持
  3. Pylance：增强的Python语言服务
  4. C/C++：C/C++开发支持
  5. Remote-SSH: Editing Configuration Files：管理SSH配置
  6. Remote Explorer：更方便地查看远程资源

四、使用VSCode连接树莓派

4.1 设置SSH连接

  1. 打开命令面板：

    • 按F1或Ctrl+Shift+P
    • 输入并选择"Remote-SSH: Connect to Host..."

  2. 添加新的SSH主机：

    • 选择"+ Add New SSH Host..."
    • 输入SSH连接命令：ssh username@raspberrypi_ip
      • 将username替换为树莓派的用户名（默认为"pi"）
      • 将raspberrypi_ip替换为树莓派的IP地址
    • 选择配置文件保存位置（通常是第一个选项）
    • VSCode会询问是否连接，选择"Connect"

  3. 首次连接确认：

    • 首次连接会询问是否信任主机，选择"Continue"
    • 输入树莓派用户的密码

4.2 连接成功与工作区设置

成功连接后：

  1. 创建工作区：

    • 选择"File" > "Open Folder..."
    • 选择或创建项目目录（如/home/pi/projects）
    • 点击"OK"

  2. 创建工作区配置：

    • 选择"File" > "Save Workspace As..."
    • 命名并保存工作区配置文件，方便下次快速打开

五、树莓派开发环境配置

5.1 Python开发环境配置

  1. 安装Python工具：
    在树莓派的终端中运行：

    sudo apt update
sudo apt install -y python3-pip python3-venv

  2. 创建虚拟环境：
    在VSCode终端中运行：

    cd ~/projects
python3 -m venv venv
source venv/bin/activate

  3. 安装项目依赖：

    pip install numpy matplotlib flask
# 添加您项目需要的其他库

  4. 配置VSCode Python解释器：

    • 按F1打开命令面板
    • 输入并选择"Python: Select Interpreter"
    • 选择刚创建的虚拟环境（./venv/bin/python）

5.2 C/C++开发环境配置

  1. 安装C/C++工具链：

    sudo apt update
sudo apt install -y build-essential gdb cmake git

  2. 配置VSCode C/C++设置：

    • 创建c_cpp_properties.json文件：
      • 按F1打开命令面板
      • 输入并选择"C/C++: Edit Configurations (JSON)"
    • 添加树莓派特定的包含路径和编译器设置

5.3 GPIO和硬件库安装

  1. 安装Python GPIO库：

    pip install RPi.GPIO gpiozero

  2. 安装WiringPi（C语言GPIO库）：

    sudo apt install -y wiringpi

  3. 安装I2C和SPI工具：

    sudo apt install -y i2c-tools python3-smbus

六、VSCode常用开发工具配置

6.1 设置代码调试

Python调试配置

  1. 创建.vscode/launch.json文件：

    • 按F5或在"运行"菜单中选择"添加配置..."
    • 选择"Python"
    • 选择"Python File"模板
    • 修改配置：

    {
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "justMyCode": true
        },
        {
            "name": "Python: Main File",
            "type": "python",
            "request": "launch",
            "program": "${workspaceFolder}/main.py",
            "console": "integratedTerminal",
            "justMyCode": true
        }
    ]
}
C/C++调试配置

  1. 创建.vscode/launch.json文件：

    • 按F5或在"运行"菜单中选择"添加配置..."
    • 选择"C++ (GDB/LLDB)"
    • 选择"g++ build and debug active file"模板
    • 修改配置：

    {
    "version": "0.2.0",
    "configurations": [
        {
            "name": "g++ build & debug",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}/${fileBasenameNoExtension}",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "g++ build active file",
            "miDebuggerPath": "/usr/bin/gdb"
        }
    ]
}

  2. 创建.vscode/tasks.json构建任务配置：

    {
    "version": "2.0.0",
    "tasks": [
        {
            "type": "shell",
            "label": "g++ build active file",
            "command": "/usr/bin/g++",
            "args": [
                "-g",
                "${file}",
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}"
            ],
            "options": {
                "cwd": "/usr/bin"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            }
        }
    ]
}

6.2 Git版本控制配置

  1. 配置Git：

    git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

  2. 创建新Git仓库：

    • 打开VSCode命令面板（F1）
    • 输入并选择"Git: Initialize Repository"
    • 选择工作区文件夹

  3. 设置.gitignore：
    创建.gitignore文件并添加以下内容：

    venv/
__pycache__/
*.pyc
*.o
*.a
*.so

七、实用项目示例

7.1 Python GPIO LED闪烁示例

  1. 创建led_blink.py文件：

import RPi.GPIO as GPIO
import time

# 设置GPIO模式
GPIO.setmode(GPIO.BCM)

# 定义LED引脚（GPIO 18）
LED_PIN = 18

# 设置引脚为输出
GPIO.setup(LED_PIN, GPIO.OUT)

try:
    print("按下Ctrl+C退出程序")
    
    # 循环闪烁LED
    while True:
        GPIO.output(LED_PIN, GPIO.HIGH)  # LED开
        print("LED开")
        time.sleep(1)                    # 等待1秒
        GPIO.output(LED_PIN, GPIO.LOW)   # LED关
        print("LED关")
        time.sleep(1)                    # 等待1秒
        
except KeyboardInterrupt:
    print("程序已退出")
    
finally:
    GPIO.cleanup()  # 清理GPIO设置
    print("GPIO已清理")

  1. 硬件连接：

    • 将LED的正极（长脚）通过一个220欧姆电阻连接到树莓派的GPIO 18引脚
    • 将LED的负极（短脚）连接到树莓派的GND（接地）引脚

  2. 运行与调试：

    • 在VSCode中打开文件
    • 按F5开始调试
    • 观察LED闪烁和控制台输出

7.2 C语言GPIO控制示例

  1. 创建led_control.c文件：

#include <wiringPi.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>

#define LED_PIN 18  // BCM GPIO 18

int main(void) {
    // 初始化wiringPi
    if (wiringPiSetupGpio() == -1) {
        printf("WiringPi初始化失败！\n");
        return 1;
    }
    
    // 配置GPIO为输出
    pinMode(LED_PIN, OUTPUT);
    
    printf("LED控制程序启动，按Ctrl+C退出\n");
    
    // 循环闪烁LED
    while(1) {
        // LED开
        digitalWrite(LED_PIN, HIGH);
        printf("LED开\n");
        sleep(1);
        
        // LED关
        digitalWrite(LED_PIN, LOW);
        printf("LED关\n");
        sleep(1);
    }
    
    return 0;
}
  1. 编译与运行：
    • 在VSCode终端中运行： 

      gcc -Wall -o led_control led_control.c -lwiringPi
sudo ./led_control
    • 注意：WiringPi库需要sudo权限运行

7.3 Web服务器控制LED示例

创建web_led_control.py文件：

from flask import Flask, render_template, request
import RPi.GPIO as GPIO

app = Flask(__name__)

# 配置GPIO
LED_PIN = 18
GPIO.setmode(GPIO.BCM)
GPIO.setup(LED_PIN, GPIO.OUT)
GPIO.output(LED_PIN, GPIO.LOW)  # 初始状态为关闭

# 创建HTML模板（创建templates目录并添加以下文件）
"""
<!-- templates/index.html -->
<!DOCTYPE html>
<html>
<head>
    <title>树莓派LED控制</title>
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <style>
        body { font-family: Arial; text-align: center; margin-top: 50px; }
        .button {
            padding: 15px 32px;
            font-size: 16px;
            margin: 10px;
            cursor: pointer;
            border-radius: 8px;
            border: none;
        }
        .on { background-color: #4CAF50; color: white; }
        .off { background-color: #f44336; color: white; }
    </style>
</head>
<body>
    <h1>树莓派LED控制</h1>
    <p>当前状态: {{ state }}</p>
    <form method="POST" action="/">
        <button class="button on" name="action" value="on">开灯</button>
        <button class="button off" name="action" value="off">关灯</button>
    </form>
</body>
</html>
"""

@app.route('/', methods=['GET', 'POST'])
def home():
    led_state = "关闭"
    
    if request.method == 'POST':
        action = request.form.get('action')
        if action == 'on':
            GPIO.output(LED_PIN, GPIO.HIGH)
            led_state = "开启"
        elif action == 'off':
            GPIO.output(LED_PIN, GPIO.LOW)
            led_state = "关闭"
    else:
        # 获取当前状态
        if GPIO.input(LED_PIN):
            led_state = "开启"
    
    return render_template('index.html', state=led_state)

if __name__ == '__main__':
    try:
        # 在本地网络上可访问，端口5000
        app.run(host='0.0.0.0', port=5000, debug=True)
    finally:
        GPIO.cleanup()  # 确保程序退出时清理GPIO

首先创建模板目录：

mkdir -p templates

然后创建templates/index.html文件，内容见上述代码中的HTML注释部分。

运行Web服务：

python web_led_control.py

通过浏览器访问http://树莓派IP:5000控制LED。

八、优化与进阶技巧

8.1 提高远程开发性能

  1. 优化SSH连接：
    编辑PC上的SSH配置文件（~/.ssh/config）：

    Host raspberrypi
  HostName 192.168.1.100
  User pi
  Compression yes
  ControlMaster auto
  ControlPath ~/.ssh/sockets/%r@%h-%p
  ControlPersist 600

  2. 减少文件监视：
    在VSCode设置中添加：

    "files.watcherExclude": {
  "**/.git/objects/**": true,
  "**/.git/subtree-cache/**": true,
  "**/node_modules/**": true,
  "**/venv/**": true
}

8.2 自动化部署脚本

创建一个简单的部署脚本deploy.sh：

#!/bin/bash
# 部署脚本示例

# 停止可能正在运行的服务
sudo systemctl stop myapp.service

# 更新代码
git pull

# 更新依赖
source venv/bin/activate
pip install -r requirements.txt

# 重新启动服务
sudo systemctl start myapp.service

echo "部署完成！"

8.3 创建系统服务

为您的应用创建一个系统服务，使其在树莓派启动时自动运行：

  1. 创建服务文件：

    sudo nano /etc/systemd/system/myapp.service

  2. 添加以下内容：

    [Unit]
Description=My Raspberry Pi Application
After=network.target

[Service]
Type=simple
User=pi
WorkingDirectory=/home/pi/projects
ExecStart=/home/pi/projects/venv/bin/python /home/pi/projects/app.py
Restart=on-failure

[Install]
WantedBy=multi-user.target

  3. 启用服务：

    sudo systemctl enable myapp.service
sudo systemctl start myapp.service

九、常见问题与解决方案

9.1 SSH连接问题

问题: 无法通过SSH连接到树莓派
解决方案:

  • 确认树莓派是否连接到网络，IP地址是否正确
  • 验证SSH服务是否启用：sudo systemctl status ssh
  • 检查防火墙设置：sudo ufw status
  • 尝试ping树莓派：ping raspberrypi_ip

9.2 权限问题

问题: 运行程序时出现权限错误
解决方案:

  • 对于GPIO访问，使用sudo运行程序
  • 或者将用户添加到gpio组： 

    sudo usermod -a -G gpio $USER
  • 对于串口访问，将用户添加到dialout组： 

    sudo usermod -a -G dialout $USER

9.3 性能问题

问题: 树莓派运行缓慢
解决方案:

  • 确保使用适当的电源适配器（5V/3A）
  • 检查温度是否过高：vcgencmd measure_temp
  • 考虑添加散热器或风扇
  • 通过htop命令检查进程占用资源情况
  • 减少后台进程：sudo systemctl disable <不必要的服务>

十、常用资源与链接

10.1 官方文档

10.2 社区资源

10.3 推荐书籍与教程

  • 《树莓派开发实战》
  • 《Python编程：从入门到实践》
  • 《使用C/C++和Python进行物联网开发》

总结

通过本指南，您已经了解了如何使用VSCode与树莓派构建一个高效的开发环境。从初始设置到实际项目开发，再到性能优化和常见问题解决，本指南涵盖了开发过程中的各个方面。

树莓派与VSCode的结合为IoT开发、物理计算和嵌入式系统编程提供了一个强大而灵活的平台。随着经验的积累，您可以开发出越来越复杂和有趣的项目。

# vscode # ide # 编辑器
Logo
乐奇 Rokid 开放社区

更多推荐

FPC与机器人的双向赋能，解锁智能装备进化新势能

如果说AI算法、算力芯片是智能眼镜的“智慧大脑”，光学模组是智能眼镜的“视觉窗口”，那么FPC就是贯穿整机、连接所有功能模块的“柔性神经脉络”。方寸之间的柔性突破，破解了智能眼镜“轻薄形态”与“全能功能”的核心矛盾，是穿戴智能设备实现形态革新、体验升级的底层核心。未来，随着AR沉浸式技术、AI大模型、穿戴硬件技术的持续进化，智能眼镜将朝着更轻薄、更智能、更多场景、更高稳定性的方向持续迭代，对高端精

avatar 乐奇 Rokid 开放社区
cover

AI眼镜里面有晶振吗？智能眼镜的时钟系统

avatar 乐奇 Rokid 开放社区
cover

智能眼镜不再只是拍照工具，它正在学会思考、记忆和行动

avatar 乐奇 Rokid 开放社区