guide.bash.academy

The Bash Guide 是开源项目，采用 Creative Commons Attribution-ShareAlike 4.0 International License（CC-BY-SA 4.0） 许可，源码托管在 GitHub 上。想参与贡献，可以在 GitHub 上报告问题或 fork 后提交修改；想反馈意见，可以联系作者 lhunath（Maarten Billemont）、提交 issue，或到 Libera.chat 的 #bash 频道讨论。如果只是想跟进更新，给 GitHub 项目点 star 即可。

授权方式：CC-BY-SA 4.0 意味着什么

CC-BY-SA 4.0 是知识共享署名—相同方式共享许可。对普通读者来说，它意味着你可以自由阅读、复制、分发和改编这份指南，前提是：

• 署名：保留原作者（lhunath / Maarten Billemont）的署名信息；
• 相同方式共享：如果你基于这份指南做了修改并对外发布，修改后的作品也需要采用相同的 CC-BY-SA 4.0 许可。

这适合想把指南内容翻译、整理成笔记或用于教学材料的读者，但要注意保留署名并以同样的许可发布衍生内容。

参与贡献的具体路径

指南本身说明，贡献不分大小（big or small），新章节在持续撰写，已有章节也在不断更新和改进，所以发现表述不清、示例过时或内容有误，都是值得反馈的对象。

反馈前值得注意的几点

• 先确认问题是否已存在：指南是活跃维护的项目，提交 issue 前可以先浏览已有 issue，避免重复。
• 说明具体位置：反馈时指出涉及的章节（如 Inception、Commands And Arguments、Variables and Expansions 等），能让维护者更快定位。
• IRC 适合讨论而非存档：Libera.chat 的 #bash 频道适合即时交流脚本问题和获取建议，但正式的问题记录和修改建议仍建议走 GitHub issue，便于长期追踪。

适合谁参与

这份指南面向新手和长期使用 bash 的用户，目标是教人写出安全、健壮的 bash 脚本。如果你在使用中发现某段内容与自己的实践不符，或想补充某个主题的示例，都可以通过上述渠道反馈。作者写作这份指南的初衷，正是因为他发现网上充斥着不严谨的建议和错误做法，而可靠、清晰的信息又很缺乏——所以来自实际使用场景的纠错和补充，正是这个项目需要的贡献。

guide.bash.academy 是 The Bash Guide 的官方网站，一份面向新手和进阶用户的 bash shell 学习指南，目标是教人写出安全、健壮的 bash 脚本，并更高效地使用命令行。它适合想系统学习 bash、纠正错误用法或查找可靠写法的人；如果你只需要零散命令速查，它更偏“教程”而非“手册”。网站由 lhunath（Maarten Billemont）主要撰写和维护，内容开源，采用 CC-BY-SA 许可，源码托管在 GitHub，可报告问题或参与贡献，并通过 Libera.chat 的 #bash 社区交流。

内容覆盖什么

指南按章节组织，从基础概念逐步进入高级主题：

为什么可信

作者在自述中说明，他多年以志愿者身份帮助用户解决 shell 脚本问题，发现大量误解来自流传的“天真建议”、坏习惯甚至错误信息，同时缺少可靠、清晰、易获取的资料，因此写了这份指南。这个写作动机决定了它的取向：强调正确用法和安全写法，而不只是罗列命令。指南是持续更新的进行中项目，新章节在写、旧章节在改，所以内容会随时间变化。

适合谁、怎么用

• 新手：按章节顺序读，先建立“命令与参数”“变量与展开”的基础，再进入条件和循环。
• 有经验但想纠错的人：优先看 Recommendations And Pitfalls，对照自己脚本里的常见坏习惯。
• 想参与的人：到 GitHub 报告问题或 fork 贡献，也可以 star 项目跟踪更新。

需要注意，网站页面出现了打赏/付费入口的表述，但资料未说明指南本身是否需要付费或登录才能阅读，实际访问时以页面提示为准。

The Bash Guide 适合两类人：刚接触 bash、想系统建立正确概念的初学者，以及已经用了很久 bash、但希望纠正坏习惯并写出更安全脚本的长期使用者。它要解决的核心问题不是“教你几个命令”，而是帮你避开广泛流传的错误观念和不良实践，学会以正确、健壮的方式编写和使用 bash。如果你只是想零散查某个命令的用法，这份指南可能偏重；如果你希望从头建立一套可靠的 shell 知识体系，它正好对口。

这份指南的定位

The Bash Guide 自称是一份“质量驱动”的 shell 特性指南，目标是同时面向新手和高级用户，讲解 bash shell 语言的基础与高级概念。它强调两件事：

• 教你写出安全、健壮的 bash 脚本；
• 教你高效、快速地把 shell 当作命令行界面来交互使用。

作者 lhunath（Maarten Billemont）在多年志愿帮助用户解决 shell 脚本问题的过程中发现，多数人之所以出错，是因为受到大量“想当然的建议、糟糕的实践乃至彻底的错误信息”影响，同时缺乏可靠、清晰、易获取的正确资料。这份指南就是为填补这个空缺而写的。

适合你的情况

判断标准很简单：如果你的问题是“我这样写 bash 对不对、安不安全”，这份指南能帮上忙；如果只是“这个选项什么意思”，用 man 或 --help 更快。

能帮你解决的具体问题

指南的章节结构本身就说明了它覆盖的问题范围：

• Inception：bash 是什么、它在哪里；
• Commands And Arguments：如何给 bash 下达指令；
• Variables and Expansions：如何存储和处理数据；
• Tests And Conditionals：针对不同数据做判断；
• Loops And Functions：避免重复自己；
• Asynchronous Commands：后台执行与作业管理；
• Colors And Terminal Commands：对终端显示的高级控制；
• Customizing The Prompt：改变交互式 shell 的外观；
• Advanced Topics：语法糖、特定用例与 shell 技巧；
• Recommendations And Pitfalls：如何把事情做对，以及如何把事情做得非常糟糕；
• Noteworthy External Tools：bash 有局限，但可借助强大的外部工具补足。

其中“Recommendations And Pitfalls”一章最能体现它的写作动机——直接针对常见错误实践给出对照，这正是很多零散教程缺失的部分。

使用前需要知道的

• 指南是开源的，采用 CC-BY-SA 4.0 国际许可，源码托管在 GitHub，可以报告问题或 fork 参与改进。
• 它是一份持续更新的作品，新章节在写、旧章节在改，内容并非一次定型。
• 想跟进更新可以 star 其 GitHub 项目；反馈和建议可通过联系作者、提交 issue 或访问 Libera.chat 的 #bash 频道。
• 页面出现了付费相关的金额与 PayPal 字样，但资料未说明具体价格、访问限制或是否必须付费，实际使用前请以网站当前说明为准。

怎么用最有效

按章节顺序读，遇到与自己脚本相关的主题再回头精读对应章节；读完“Recommendations And Pitfalls”后，拿自己现有的脚本对照检查一遍，往往能立刻发现几处长期存在的隐患。这比继续收集零散技巧更能提升脚本质量。

不需要付费即可阅读 The Bash Guide 的章节内容。页面上的 PayPal 多币种金额选择是自愿资助入口，不是付费墙或订阅购买流程；网站资料没有说明内容访问受付款限制。你可以先直接阅读各章节，再决定是否支持作者。

页面上的付款表单是什么性质

The Bash Guide 首页在章节列表上方有一段带金额选择的文字，大意是“感谢你的贡献，我愿意为获得本指南访问权支付 US $ / ₽ / £ / € / C$ / A$”。结合网站其他说明，这个表单应理解为对作者和项目的自愿资助，而不是购买访问权限：

• 指南本身以 CC-BY-SA 4.0 许可开源发布，源码托管在 GitHub，可自由阅读、fork 和提交修改。
• 网站没有出现“付费后解锁”“订阅”“登录后阅读”等访问限制说明。
• 付款平台为 PayPal，金额选项覆盖多种货币，符合捐赠/赞助表单的常见形态。

因此，看到金额选项不等于内容被锁住。判断标准很简单：能否不付款直接打开章节页并读到正文。按现有资料，答案是能。

正确的使用顺序

1. 先读内容：从首页章节列表进入任意一章，例如 Inception、Commands And Arguments、Variables and Expansions，确认正文可正常阅读。
2. 按需学习：指南面向新手和长期用户，讲 bash 脚本的安全写法和命令行高效交互，不需要先完成任何付款步骤。
3. 再决定是否支持：如果内容对你有帮助，再回到首页使用 PayPal 表单自愿资助；金额和币种由你选择。
4. 参与贡献不必付款：反馈问题、报告错误或提交修改，走 GitHub issue 或 fork 流程即可，与付款无关。

常见卡点

• 把金额选择误认为价格表：页面没有标注“价格”“购买”“订阅”等字样，金额旁的文字是感谢贡献的表述，不应推导为必须支付。
• 担心不付款看不到完整章节：资料未提及任何付费墙；若实际访问时遇到登录或付款拦截，以网站当时的实际说明为准，而不是依据首页表单推测。
• 想确认资助去向：指南由 lhunath（Maarten Billemont）主要编写和维护，开源许可和 GitHub 仓库公开，可先查看项目再决定是否支持。

一句话结论

The Bash Guide 是可免费阅读的开源 bash 学习指南；首页的 PayPal 金额表单是自愿资助入口，不是访问门槛。先读章节，觉得有价值再支持作者即可。

The Bash Guide（guide.bash.academy）是一份面向新手和进阶用户的 bash shell 学习指南，核心章节覆盖从“bash 是什么”到高级技巧的完整路径，并专门设有推荐做法与常见陷阱、外部工具两个实践性章节。它适合想系统学习 bash 脚本写法、同时避免常见错误用法的人；内容以英文撰写，采用 CC-BY-SA 许可开源发布，源码托管在 GitHub，可提交问题或参与贡献。

入门与基础章节

指南的前半部分按“先理解 shell，再写指令，再处理数据”的顺序展开：

这几章构成从零开始的主干：先建立对 shell 运行环境的认识，再进入命令、变量展开、条件判断和循环函数。对已经会写简单脚本的人，变量与展开、测试与条件两章仍值得回看，因为很多脚本错误正出在对展开规则和判断语义的误解上。

进阶与交互章节

基础之后，指南转向更贴近日常使用的主题：

• Asynchronous Commands：在后台执行任务并管理作业。
• Colors And Terminal Commands：对终端显示进行更高级的控制。
• Customizing The Prompt：改变交互式 shell 提示符的外观与信息。
• Advanced Topics：语法糖、特定使用场景和 shell 技巧。

这一部分面向已经能写脚本、希望提升交互效率的用户。提示符定制和终端颜色控制直接改善命令行使用体验；异步命令与作业管理则关系到后台任务的正确组织方式。

实践建议与外部工具

指南末尾有两个偏“经验”的章节：

• Recommendations And Pitfalls：说明怎样做是对的，以及哪些做法非常糟糕。
• Noteworthy External Tools：bash 本身能力有限，但可以借助强大的工具集扩展。

作者 lhunath（Maarten Billemont）在说明写作动机时提到，他多年做志愿教学，发现多数用户的 shell 脚本问题源于流传甚广的幼稚建议、不良实践甚至错误信息，因此专门写了这份指南来提供可靠、清晰、易获取的知识。这也解释了为什么“推荐做法与常见陷阱”被单列成章——它针对的正是学习者在网上照抄坏例子的典型困境。

怎么判断是否适合你

• 如果你是刚接触 bash：按章节顺序从 Inception 读到 Loops And Functions，能建立较完整的正确概念，避免一开始就养成坏习惯。
• 如果你是有经验的用户：可直接跳到 Advanced Topics、Recommendations And Pitfalls 和 Noteworthy External Tools，用来查漏补缺和纠正旧习惯。
• 如果你需要中文材料：该指南为英文内容，可作为系统学习的主线，配合中文资料对照理解。

指南仍在持续更新，新章节在写、已有章节不断修订；想跟进变化可以关注其 GitHub 项目，遇到问题也可通过 GitHub issue 或 Libera.chat 的 #bash 社区反馈。