豆包MarsCode + 开源 = ？AI 助力开源社区新人成长

“开源”这个词，对开发者来说，可能是入门时的第一步，也可能是追求极致技术的终点。无数优秀的开源项目不仅推动了技术的进步，也成为开发者学习和成长的宝藏，但同时也因为其规模庞大、代码复杂，常让人感到望而生畏，尤其是对于刚接触开源的开发者。为了帮助新人快速融入社区， 提升新人的学习体验，一般开源社区都会提供正式、非正式的导师指导计划。但因为社区导师资源有限，当新人遇到问题的时候，我们也鼓励大家采用搜索引擎，以及阅读代码的方式定位和解决问答，也就是自助解决优先的方式。

找到入门的关键，理清项目的架构，快速理解核心逻辑 —— 这些技能往往需要丰富的经验与大量的时间积累。然而，随着 AI 和智能开发工具的兴起，学习开源项目正在变得更简单、更高效。作为一款专为开发者设计的智能工具，豆包MarsCode 通过代码解释、#workspace 等能力，帮助开发者快速掌握开源项目的核心思想，直击学习痛点。你将不再需要花费数小时梳理文档、不再迷失在复杂的代码海洋中——豆包MarsCode 让你在学习开源项目时事半功倍，从入门到进阶，一步到位。

有了豆包MarsCode 编程助手的帮助，我们可以快速高效的了解一个项目的核心逻辑与模块构成，轻松几步就能完成开源项目的代码贡献。如果你还没有想法或者不知道该从哪里下手也没有关系，可以跟随这篇文章的脚步来了解如果从零开始为开源项目添砖加瓦，成为一名真正的“开源项目贡献者”吧！Let's GO!

目前 VChart issue 中挂了许多的特性开发任务以及环境兼容任务。给 VChart 添加 Vue 环境的支持需要对 Vue 生态有一定的掌握，优化鸿蒙环境下的 VChart 使用本身也需要先足够了解鸿蒙本身的语法与环境能力，这些任务对于初心者而言可能有些难度。我们可以从教程补充之类的简单任务着手，逐步了解 VChart 项目本身的逻辑，一步步向更有挑战的工作进发。在这篇文章里我们就从“补充 Scales 相关教程”的任务入手吧。

选定任务了，让我们开始敲代码！

如果你对于 VChart 项目本身还并不太熟悉的话，可以加入 VisActor 微信群组或者 VisActor 的飞书群组提出任何感兴趣的问题。群里的热心同学们会积极帮助所有外部开发者解惑答疑，不用觉得害羞，尽管去提问吧~

如果你想要依靠自己的力量来理解 VChart 的核心逻辑，但是又觉得一口气阅读 VChart 这么多的代码有些抓不到思路，不知道如何掌握 VChart 项目的脉络的话，那不妨来试试豆包MarsCode 编程助手的大模型对话能力。无论是使用 VScode 还是 Jet Brains 系列的编辑器，豆包MarsCode 都提供了相应的编辑器插件，能够帮助你快速接入大模型能力，提升编码与开发效率。比如让我们先问问 packages/vchart 这个核心包里头究竟包含了哪些重要模块呢：

又或者你可以向 MarsCode 询问 VChart 中某一个类的核心函数是用来做什么的：

有了豆包MarsCode 的辅助，相信以你聪明的小脑瓜肯定能很快了解 VChart 的代码逻辑辣。如果还有什么不清楚的，群组里头的热心同学们也随时为你效劳~

观察 VChart 的项目结构，可以看到的所有的文档内容都存放在 根目录/docs/assets 路径里头。

需要注意啦，VChart 中所有的教程文档都是按照原生的 MarkDown 的格式编写的，所有的配置项文档都是按照嵌套的 MarkDown 格式编写的。两者的差异在于前者可以在任何的 MarkDown 编辑器/阅读器中查看，后者则需要通过编译以及执行 VChart 本地命令才能查看。

万里长征第一步：找到落笔的地方，写下第一行内容。顺着 Scale 代码类型定义的脉络一路找到最终 ScaleType 的类型定义。可以看到 ScaleType 里除了现在教程里头包含的 linear 以及 ordinal 两种类型以外，还包含了 band、point 以及 threshold 类型。

那么这些 Scale 类型又是什么含义呢？让我们来问问万能的豆包MarsCode 编程助手吧。

好，我们已经彻底理解了 Band Scale 的含义，是时候让我们开始编写具体的教程内容了！

Scale 的配置文档内容存放在 visual-scale-spec.md 文件中，先找到这个文件，然就可以开始写下第一行代码内容辣。

当然了，在你添加相应文档内容的时候，豆包MarsCode 编程助手仍然在勤勤恳恳的工作中！它会在在你专心致志敲击键盘的时候自动补全后续的文字，帮助你省去一大堆的重复劳动时间。话不多说，快端上来吧：

所有文档编写就绪之后，也别忘了在 VChart 项目中运行 rush update 以及 rush docs 命令来执行文档的渲染，检查一下自己的文档内容是否正确呀。

代码就绪之后，最后一步就该是推送代码内容，提交 Pull Request，等待自己的代码正式合入啦。

向 VChart 仓库的 Push 分支提交 Commit 内容需要等待单元测试的执行完成。不过对于我们的教程编写而言并没有什么影响，只要稍作等待，就可以在 VChart 项目中提起 Pull Request 了：

提交 PR 之后 VChart 的相关同学会查看你所提交的 PR 内容，并且与你就 PR 内容做一些讨论。如果大家拜读了你所编写的精妙绝伦的代码之后觉得毫无问题，那就是万事俱备，可以合入代码啦。

如果 PR 交流的过程发现了一些问题也不要灰心，可以就讨论的结果做一些相应的修改。负责 Review PR 的同学也会持续跟进 PR 的调整，确保内容最终能够顺利合入仓库。

VisActor 联合豆包MarsCode、稀土掘金、中国气象网、上海交通大学发起本挑战赛

比赛分为三个赛道，并由字节跳动专家作为导师，还有丰富的礼品欢迎大家参与～

可视化创意编程

▪️ 基于VChart的象形图表：要求参赛者使用VChart象形图组件进行扩展，内容和形式自由发挥。

▪️ 基于VStory开发动态信息图：使用VStory进行信息图demo开发，形式自由发挥，自行编排动画和叙事逻辑。

▪️ 散点关系图：详情为时序散点关系图。

▪️ 表格叙事：使用VStory中的VTable接口，完成一个基于表格叙事的作品。

▪️ Joytoy产品介绍作品：使用VStory，通过数据可视化形式对Joytoy的机甲产品进行介绍。

▪️ VTable源码解读：征集VTable源码的解读文档。

▪️ VChart源码解读：征集VChart源码的解读文档。

▪️ 豆包MarsCode 最佳使用奖：评选标准为参赛者记录参与VisActor开发过程中使用豆包MarsCode 的过程和精彩瞬间，形成文档，对外发布。

▪️ 豆包MarsCode 幸运奖：比赛期间，活动群每周进行一次幸运抽奖，要求上传豆包MarsCode 使用截图。