本页由英文原文机器翻译而成。
参与贡献
适合第一个 pull request 的 three.js 太空项目
Space Radar 是一张开源的三维太空地图,用 three.js 和普通的 ES 模块编写,不需要构建步骤。在 2026年11月1日,它有 269 个还没有人认领的新手 issue。每一个都写明文件、改动、要运行的检查,以及做到什么程度算完成。很多根本不需要 three.js。
查看开放的 issue
这个列表是 GitHub 自己的,所以总是最新的。
按你喜欢做的事来选
| 方向 | 典型的任务 | 你需要 |
|---|---|---|
| 把一个数字和它的来源核对 | 在一条 YAML 注释里写明一个数字是在哪个网页、哪一天读到的 | 一个浏览器 |
| 整理文字和注释 | 修正一条指向已经移动过的文件的注释 | 一个浏览器 |
| 写一个测试 | 在一个新的测试文件里,固定一个小函数的返回值 | Node 22,或者一个 Codespace |
| 做一个小的代码改动 | 让一个脚本响应 --help,而不是打印出错信息 | Python 3 或 Node 22 |
| CSS 和外观 | 把一个间距值放到 4 px 的网格上 | 一个浏览器 |
| 做一样你能看到的东西 | 用一个 HTML 文件做一个小模拟器,不用任何程序库 | 一个浏览器 |
代码是什么样的
- 应用按原样提供:没有打包工具,也没有框架。克隆下来,运行 Python 自带的网页服务器,它就能打开。
- 渲染用的是 three.js。地图知道的东西大多放在 YAML 登记表里,每一行都有来源。
- 一条命令
scripts/check.sh,就能运行 pull request 要通过的快速检查,并说明每个失败该怎样修。 - 许可是 MIT。
你的 pull request 会怎样
如果检查全部通过,而且它不是草稿,它会自动合并,你的名字会出现在版本说明和贡献者名单里。改变产品功能的改动,要先在 issue 里讨论。
大多数提交来自一个由 AI 编程代理在项目创始人名下操作的账号,这个账号和其他所有人一样,要通过同样的测试、遵守同样的来源要求。治理页面说明了谁决定什么;目前还没有外部审阅者:你可能会是第一个。
从这里开始
也想看看别的地方?
GitHub 为大多数代码仓库保留了一个新手列表,地址以 /contribute 结尾;如果你想参与这个程序库本身,而不是用它做出来的东西,three.js 本身的那个列表是个好去处。