feat: update docs and components, fix DLQ demo bug

This commit is contained in:
sanbuphy
2026-01-18 12:21:49 +08:00
parent 26ed39e1eb
commit e41063a1cd
159 changed files with 54236 additions and 2525 deletions
+25 -17
View File
@@ -62,6 +62,7 @@
百闻不如一见。为了让你真正感受到 IDE 的便捷,我们为你准备了一个**虚拟的 VS Code 环境**。
**请尝试以下操作**
1. 点击右上角的 **“▶ 开始自动导览”**,跟随光标了解各个区域。
2. **自由探索**:点击左侧图标切换视图,或者点击文件名打开代码。
3. **体验集成**:你会发现,文件管理、代码编辑、终端运行,都在同一个窗口内无缝衔接。
@@ -82,16 +83,18 @@
想象一下,你刚下载好的 VS Code,如果不安装任何插件,它其实**并不懂编程**。
此时的它,本质上只是一个**功能强大的文本编辑器**。
* 它负责显示文字(渲染)。
* 它负责管理文件(IO)。
* 但它不知道 `print("Hello")` 是 Python 代码,也不知道 `int main()` 是 C++ 入口
- 它负责显示文字(渲染)。
- 它负责管理文件(IO
- 但它不知道 `print("Hello")` 是 Python 代码,也不知道 `int main()` 是 C++ 入口。
### 3.2 插件系统:注入“灵魂”
为了让 VS Code 能够“理解”代码,我们需要安装**插件 (Extensions)**。
插件就像是专门的**翻译官**
* **Python 插件**:告诉 VS Code 什么是变量,什么是函数,怎么运行 `.py` 文件。
* **C++ 插件**:告诉 VS Code 如何调用编译器,如何调试内存
- **Python 插件**:告诉 VS Code 什么是变量,什么是函数,怎么运行 `.py` 文件
- **C++ 插件**:告诉 VS Code 如何调用编译器,如何调试内存。
这种设计使得 VS Code 非常轻量——你不写 Java,就不用背负 Java 的运行环境。
@@ -105,14 +108,18 @@
假设你写了一行 Python 代码并点击了**运行**或**调试**:
#### 1. 语言识别 (Activation)
VS Code 检测到 `.py` 后缀,自动唤醒 **Python 插件**。插件立刻接管了编辑器,开始进行语法分析,将代码染上不同的颜色(语法高亮),并提供智能提示。
#### 2. 任务委托 (Delegation)
当你下达指令时,插件本身并不直接执行代码,而是将任务**委托**给底层的专业工具:
* **运行模式**:插件生成一条指令(如 `python main.py`),发送给系统的**终端**去执行。
* **调试模式**:插件启动一个**调试适配器 (Debug Adapter)**。它就像一个“监控探头”,连接到 Python 解释器内部,让你能一行行地控制代码执行。
- **运行模式**:插件生成一条指令(如 `python main.py`),发送给系统的**终端**去执行。
- **调试模式**:插件启动一个**调试适配器 (Debug Adapter)**。它就像一个“监控探头”,连接到 Python 解释器内部,让你能一行行地控制代码执行。
#### 3. 结果反馈 (Feedback)
Python 解释器(或编译器)执行完代码,将结果(或错误信息)返回给插件。插件再把这些信息“搬运”回来,显示在 VS Code 的**底部终端面板**中。
### 3.4 总结:用“餐厅”来打个比方
@@ -120,22 +127,23 @@ Python 解释器(或编译器)执行完代码,将结果(或错误信息
如果觉得上面的公式有点抽象,我们可以把写代码的过程想象成**去餐厅吃饭**:
1. **VS Code 是“餐厅大堂”**
* 这里装修豪华,环境舒适(代码高亮、好看的主题)。
* **但大堂本身不生产食物**。你坐在这里,只是为了更舒服地“点菜”(写代码)。
- 这里装修豪华,环境舒适(代码高亮、好看的主题)。
- **但大堂本身不生产食物**。你坐在这里,只是为了更舒服地“点菜”(写代码)。
2. **环境 (Python/Node) 是“后厨”**
* 这是真正**做饭(运行代码)**的地方。
* 如果餐厅没有后厨(没安装 Python),你在大堂坐到天黑也吃不上饭。
- 这是真正**做饭(运行代码)**的地方。
- 如果餐厅没有后厨(没安装 Python),你在大堂坐到天黑也吃不上饭。
3. **插件 是“服务员”**
* 他连接了大堂和后厨。
* 他看得懂你的菜单,跑去告诉后厨:“3 号桌要一份‘运行 main.py’!”
* 做好了,他又把结果(热腾腾的饭菜)端回到你面前。
- 他连接了大堂和后厨。
- 他看得懂你的菜单,跑去告诉后厨:“3 号桌要一份‘运行 main.py’!”
- 做好了,他又把结果(热腾腾的饭菜)端回到你面前。
**结论**
* 只装 VS Code = **只有大堂没后厨**(只能看,不能吃)。
* 只装 Python = **只有后厨没大堂**(能吃,但得蹲在厨房地上吃,体验很差)。
* **装了 VS Code + 插件 + Python = 完美的就餐体验。**
- 只装 VS Code = **只有大堂没后厨**(只能看,不能吃)。
- 只装 Python = **只有后厨没大堂**(能吃,但得蹲在厨房地上吃,体验很差)。
- **装了 VS Code + 插件 + Python = 完美的就餐体验。**
---