仓颉编程语言零基础入门终极指南从环境搭建到提交首个PR的完整实战教程【免费下载链接】CangjieCommunity为仓颉编程语言开发者打造活跃、开放、高质量的社区环境项目地址: https://gitcode.com/Cangjie/CangjieCommunity仓颉编程语言是面向全场景智能应用开发的新一代编程语言官方开源社区 CangjieCommunity 汇聚了编译器、运行时、标准库与海量示例资源是新手入门的第一站。这篇教程不堆砌概念而是按真实项目推进的节奏带你走完全程装好工具链、跑通第一个程序、用好包管理器最后亲手向社区提交一份代码把你的名字写进贡献者名单。出发之前先弄清仓颉能为你做什么这门语言的底气在哪里仓颉主打四个关键词原生智能化、天生全场景、高性能、强安全。翻译成大白话就是——它既能写跑在电脑和服务器上的普通应用也能写鸿蒙原生应用还能覆盖云端一体化的智能场景而且编译器、运行时和标准库全部开源你随时可以钻进源码里看个究竟。对新手最友好的点在于你不需要一步到位读懂所有源码。社区仓库里已经整理好了清晰的入口你想了解的层面对应开源仓库上手难度语言本身怎么写cangjie_compiler编译器源码中程序怎么跑起来cangjie_runtime运行时与标准库低日常开发工具cangjie_tools包管理、格式化、语言服务低网络与安全能力cangjie_stdx通用扩展模块中给自己做个定位自测每个人的起点不同别盲目从第一页啃起。先对号入座你的身份建议从哪一章开始预期收获完全没接触过仓颉第二节装环境半小时内让工具链就绪装过但没写过代码第三节第一个程序跑通并读懂项目结构能写简单程序第四、五节加速包 提交PR用上三方库并完成首次贡献动手装环境三步让工具链就绪第 1 步确认电脑满足最低要求在开始之前先花一分钟做个体检避免装到一半才发现环境不兼容操作系统Windows 10/11、macOS 10.15、主流 Linux 发行版均可内存8GB 起步推荐 16GB编译大型项目时更从容磁盘预留 5GB 以上空间网络需要稳定的网络下载依赖与工具链第 2 步选择你的安装路线仓颉提供稳妥版和尝鲜版两条路线目的不同选择也不同。路线 A通用版本推荐新手这是绝大多数人的首选。社区按稳定性将版本分为三档长期稳定版 LTS、每半年发布的稳定版 STS、每天更新的 Nightly 尝鲜版。下载安装包后一路跟随向导完成安装即可仓库根目录的 通用版本获取与安装配置.pdf 有完整的图文步骤遇到问题随时翻阅。路线 B开发版本适合想深度参与的人如果你不满足于只当用户想看看社区到底在做什么可以先把社区仓库拉到本地git clone https://gitcode.com/Cangjie/CangjieCommunity仓库里除了代码还沉淀了大量一手资料贡献流程、团队分工、往期 Workshop 讲稿都在其中后面几节我们会逐一用到。第 3 步验证安装并配置环境变量安装完成后打开终端执行下面两条命令看到版本号输出就说明安装成功cj --version cjpm --version如果提示找不到命令多半是 PATH 没配置好。手动把工具链路径加进去然后重新打开一个终端窗口再试PATH 添加/usr/local/cangjie/bin库路径设置/usr/local/cangjie/lib 一个小建议把仓颉工具链的路径放在 PATH 最前面避免和其他语言工具链的命令重名冲突。环境自检清单cj --version能输出版本号cjpm --version能输出版本号新建终端后命令依然可用环境变量已持久化写出第一个程序五分钟让你好仓颉跑起来初始化项目骨架找一个干净的目录执行初始化命令生成项目cjpm init hello-cangjie cd hello-cangjie生成的骨架长这样结构一目了然hello-cangjie/ ├── src/ # 源码目录你的代码都放这里 ├── tests/ # 测试代码目录 ├── cjpm.toml # 项目配置文件依赖、构建选项 └── README.md # 项目说明写代码并运行在src目录下新建一个源文件敲入下面的内容package main import std.io func main() { io.println(你好仓颉) io.println(我的第一个仓颉程序跑起来了) }保存后依次执行cjpm build cjpm run看到终端打印出两行问候语恭喜你已经正式跨过环境可用到程序可跑的门槛了。 别急着往下翻先做个 30 秒的小实验把引号里的文字改成你自己的名字再跑一次cjpm run感受一下改代码 → 看结果的完整回路。上手加速包包管理器、示例代码与编辑器跑通 Hello World 之后很多人会卡在接下来写什么上。这一节给你三样加速工具。用 cjpm 管理依赖仓颉的包管理器叫cjpm用法和主流包管理器非常接近cjpm add 包名版本号 # 添加依赖 cjpm build # 构建项目 cjpm test # 运行测试 cjpm clean # 清理构建缓存 cjpm update # 更新依赖版本依赖声明会自动写进cjpm.toml整个项目的依赖关系一目了然。从官方示例抄作业与其从零憋代码不如先抄作业。社区维护了一批小而美的示例程序覆盖趣味算法、桌面工具、鸿蒙应用等场景每一个都是带着设计意图写好的规范样例非常适合作为仿写对象。看完示例再自己动手改造成长速度会快得多。配置编辑器与三方库日常开发推荐VSCode 官方仓颉插件的组合安装后即可获得语法高亮、代码补全、智能诊断等能力官方专属 IDE 也正在开发内测中值得期待。写业务功能时先别急着造轮子——社区优质项目清单见仓库内 社区优质开源项目.md已经按分类整理好了现成轮子分类你能找到什么开发框架Web 框架、ORM、依赖注入容器、跨平台 GUI 封装算法与协议库图算法、分词器、邮件、YAML/TOML 解析通用能力MySQL 驱动、缓存库、支付 SDK、命令行框架辅助工具C 头文件转仓颉、JSON 转类结构、大模型代码助手进阶挑战向 CangjieCommunity 提交你的第一个 PR如果说前面的内容让你学会用这一节会让你真正参与进来。向开源社区提交 PR 是新手快速提升代码品位的最佳路径——你会被真实评审逼着规范 commit、写清变更说明、打磨代码质量。先看一遍完整流程社区的贡献流程在 contribute/contribution.md 里有完整图文说明核心是七个步骤Fork 目标仓库到自己的账号把 Fork 仓克隆到本地基于 dev 分支拉出开发分支修改代码并规范提交推送到自己的 Fork 仓创建 PR 并关联 Issue触发门禁、通过评审、等待合入本地提交的规范姿势代码改完后提交信息要遵循约定式提交规范Conventional Commits并且每条 commit 都必须包含 Signed-Off-By 签名git add src/你的改动文件 git commit -sm feat: 添加某个新功能 git push -f origin 你的分支名一个高质量的 commit 信息长这样feat: 增加日志清理能力 在 xxx 模块中增加按天清理历史日志的功能 避免日志文件无限增长占用磁盘。 Refs: #12创建 PR 并关联 Issue推送成功后从你的分支向目标仓库的 dev 分支发起 PR。创建成功后系统会自动回复一份引导说明其中有两点是硬性要求PR 必须关联 Issue按模板在描述里填入 Issue 的完整链接否则门禁不会触发多仓改动要联动如果一次改动涉及多个仓库比如同时改编译器和运行时每个仓库都要建 PR且全部关联同一个 Issue回复指令触发门禁门禁不是自动跑的需要你在 PR 评论区主动回复指令指令作用适用场景start build主要基础检查commit 格式、静态告警、多平台构建、测试日常提交推荐start full build更全面的检查耗时更长内测中的深度验证多平台构建会覆盖 Linux、Windows、macOS 三个平台构建任务和测试任务的状态都可以在检查页签里实时看到如果是多仓联动的 PR只需在任意一个PR 里回复一次指令门禁通过后所有关联 PR 会同步状态无需重复触发通过评审并等待合入全部门禁检查通过后系统会在评论里给出明确结论。这时只差最后一步满足合入条件后由协作者回复start merge完成合并注意不能合并自己创建的 PR。合入条件自检清单门禁检查结果为成功build-test-passed满足最低评审人数至少 2 位开发者评审 1 位 committer 审查所有评审意见已解决每条 commit 均含 Signed-Off-By 信息⚠️ 请珍惜门禁资源不要拿线上门禁当本地编译器用提交前先自行构建验证建议单次 PR 的门禁触发不超过 3 次。详细的代码合入标准与 committer 名单见 contribute/codemerge.md门禁机器人支持的指令速查表在 infrastructure/build_command.md。新手高频踩坑区五个坑提前绕开坑 1commit 缺少签名门禁直接红灯很多人第一次提交就挂在Signed-Off-By上。记住用git commit -sm提交并保持每条 commit 信息遵循约定式提交规范。坑 2PR 没关联 Issue门禁无法触发这是最常见的卡住原因。创建 PR 时务必按模板填入 Issue 完整链接并保证一个 Issue 不重复创建。坑 3更新代码后门禁不会自动重跑创建 PR、更新代码、重新打开 PR 都不会自动触发门禁需要在评论区重新回复指令才会重新构建。坑 4想把 Markdown 改动混进代码 PRMarkdown 类修改只触发文档构建测试不会触发编译测试。文档改动和代码改动分开提交双方都省事。坑 5环境变量失效装完才发现命令找不到先手动补 PATH再重启终端验证最后确认没有和其他语言的工具链重名。排查通用套路构建失败时按cjpm clean→cjpm update→ 检查网络 → 重新cjpm build的顺序依次排除能解决九成问题。下一步路线图从会用走向会贡献、会创造提交过第一个 PR你的仓颉之旅才刚刚开始。社区为不同兴趣的开发者准备了多条成长路径你的兴趣方向可以做什么资料在哪听大咖分享参加每月一次的线上 Workshop主题涵盖语言设计、编译器实现、应用实战Workshop/workshop.md研究语言底层观看类型推断、并发机制、GC 等技术分享实录技术分享.md参与源码共建按兴趣加入编译器、运行时、标准库、IDE 等方向的小组team/做点有趣的项目报名三方库招募、投稿示例程序、认领开源毕设课题见 README.md 社区活动章节给自己定一个 30 天小目标本周跑通环境与第一个程序读完一篇 Workshop 讲稿第 2 周用 cjpm 引入一个三方库做出自己的小工具第 3 周在社区仓库找一个 good-first-issue 认领第 4 周提交你的第一个 PR 并完成合入从下载安装到代码合入你走过的每一步社区都为你准备了清晰的文档和热心的伙伴。工具是练出来的代码是改出来的现在就从打开终端、敲下第一行命令开始吧。【免费下载链接】CangjieCommunity为仓颉编程语言开发者打造活跃、开放、高质量的社区环境项目地址: https://gitcode.com/Cangjie/CangjieCommunity创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考