# pxt-microbit

**Repository Path**: starjson/pxt-microbit

## Basic Information

- **Project Name**: pxt-microbit
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-02-09
- **Last Updated**: 2026-02-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# pxt-microbit
## 简介

pxt-microbit 是 [Microsoft MakeCode](https://makecode.com/) 针对 [BBC micro:bit](https://microbit.org/) 的官方编程目标靶。它提供了一个完整的 Web 编辑器，允许用户使用 Blocks（图形化编程）、JavaScript 或 Python 为 micro:bit 编写程序。本仓库包含了编辑器的前端代码、丰富的教学文档以及桌面版固件上传工具。

## 主要功能

*   **在线编辑器**：在浏览器中直接编程并仿真。
*   **完整的课程体系**：包含入门教程 (`docs/lessons/`)、创意项目 (`docs/projects/`) 以及系统化课程 (`docs/courses/`)。
*   **API 参考**：详细的库函数文档，涵盖输入、音乐、无线电、引脚等。
*   **桌面上传器**：提供 macOS (`clients/macuploader/`) 和 Windows (`clients/winuploader/`) 客户端，方便用户将编译好的程序（hex 文件）烧录到设备。
*   **本地开发支持**：支持开发者本地搭建编辑器环境，进行核心库或扩展开发。

## 项目结构

*   **`docs/`**：文档和教程的核心目录。
    *   `lessons/`: 循序渐进的学习课程。
    *   `projects/`: 各类创意项目指南。
    *   `courses/`: 完整的教育教学大纲。
    *   `reference/`: API 编程参考手册。
*   **`clients/`**: 桌面应用程序源代码。
    *   `macuploader/`: macOS 平台的烧录工具。
    *   `winuploader/`: Windows 平台的烧录工具。
*   **`libs/`**: 包含 micro:bit 的核心库定义和运行时接口。
*   **`compiler/`**: TypeScript 编译器相关配置。

## 快速开始

### 在线使用
无需安装任何软件，直接访问 [makecode.microbit.org](https://makecode.microbit.org/) 即可开始编程。

### 本地开发环境搭建

如果你需要在本地运行编辑器或参与项目开发，请按照以下步骤操作：

1.  **环境准备**：
    *   安装 [Node.js](https://nodejs.org/) (推荐 8.9.4 或更高版本)。
    *   安装 [Git](https://git-scm.com/)。
2.  **克隆与安装依赖**：
    ```bash
    git clone https://github.com/microsoft/pxt-microbit
    cd pxt-microbit
    npm install -g pxt
    npm install
    ```
3.  **运行本地服务器**：
    ```bash
    pxt serve
    ```
    在浏览器中打开终端显示的本地地址（通常是 `http://localhost:3232`）即可使用编辑器。

*注意：若需修改底层的 C++ 运行库（如 DAL/CODAL），请参考原文档中的 "Modifying DAL/CODAL locally" 章节进行额外的环境配置。*

## 相关仓库

pxt-microbit 的运作依赖于以下几个核心仓库：

*   **PXT Framework**: [https://github.com/Microsoft/pxt](https://github.com/Microsoft/pxt) (核心框架)
*   **pxt-common-packages**: [https://github.com/Microsoft/pxt-common-packages](https://github.com/Microsoft/pxt-common-packages) (通用 API 库)
*   **microbit-dal**: [https://github.com/lancaster-university/microbit-dal](https://github.com/lancaster-university/microbit-dal) (设备抽象层)

## 许可证

本项目采用 MIT 许可证 - 详情请参阅 [LICENSE.txt](LICENSE.txt)。

## 行为准则

本项目已采用 [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)。如有问题，请联系 [opencode@microsoft.com](mailto:opencode@microsoft.com)。