# 实作文章模板
本文件是编写用模板,不是已发布的知识文章。先按维护流程确定契约、来源和验证计划,再复制到对应主题目录;把标题改为具体问题,删除不适用的栏目和所有编写提示。可参考字符串转端口号的契约与调用方式;参考文章不自动作为运行通过的证据。
开头用一两句写清学习目标。列出必要的前置知识和不展开的机制。跨页面导航由渲染器自动生成。从当前模板目录复制到主题目录后,重新检查所有相对路径。
篇内目录由渲染器根据二、三级标题自动生成,无需手写锚点列表。有多种语言时使用三级标题。
# 问题与边界
描述一个真实任务,而不是先指定要使用的语法。分别定义输入类型、格式、范围、成功结果、失败行为和非目标。给出具体案例及预期结果;边界用例应能区分正确实现与常见误写。数值题包括中间结果的溢出和精度边界,文本题说明编码与空白范围。若各语言存在不可消除的语义差异,在这里说明共同输入域和比较范围。
# 关键差异
选择本题真正相关的比较维度,用一个短表呈现,例如返回契约、失败传播、是否支持表达式取值、资源归属。先交代概念区别,再进入语言实现。不用同一张固定大表比较每道题,不按代码行数评判语言。
# 各语言实现
保留本题适用的语言,每种语言用三级标题。下方为一个语言小节的写作顺序,按需复制;把“语言名称”替换为 Rust、Go 等真实名称。
# 语言名称
- 写明基线之外的环境要求和本例选用的机制;涉及 Node.js 时注明模块模式,涉及新增 API 时核对运行时版本。
- 完整程序前不重复添加保存文件和常规运行提示;片段须明确标注并说明必要的文件关系。代码围栏使用真实语言标识,不把省略号当成实现。
- 只解释关键差异、必要语法和非显而易见的约束,就近引用对应官方资料。
- 片段另给可组装的调用入口,说明 import、作用域和拼接顺序;替换片段指出替换哪一处、其余保留什么。
- 介绍失败时必须展示消费失败的调用方。明确错误分支中不会使用无效结果,也不会静默默认。
- 给出成功输出和失败表现;只为特殊运行条件补充必要命令。无输出的断言程序注明“正常结束且断言通过”,不要描述成会打印结果。
JS/TS 逻辑相同时共享说明,后续专题优先展示 TS 签名差异。语言不适用时解释原因,不为对齐表格强行添加实现。
# 迁移误区与适用限制
选取会改变可观察行为的误区,按“错误迁移方式 → 反例输入或场景 → 正确边界”说明。避免重复前面的代码解释。涉及性能或生产约束时明确条件,不凭空给出数量级结论。
# 运行与验证
汇总分散的运行入口或链接到对应语言小节;说明每种语言的独立临时目录、文件名冲突、断言启用条件和平台差异。链接验证记录中对应本篇的具体条目,按证据要求记录代码版本、日期、实际工具链、命令、结果和未执行部分,不复制容易失步的通过矩阵。
建议用例:正常路径、边界内/上/外、非法输入、失败传播,以及本题特有的资源或状态变化。正文中的预期结果与实际运行结论分别表述;无参数演示与带参数 CLI 分别记覆盖,未执行的语言不能写成“全部通过”。发布前删除内部交接语句并完成维护规范的发布清单。
# 延伸阅读
可选。只放帮助继续学习的一手资料,并说明与本篇的关系;不重复所有行内来源。没有额外资料时删除本节。
文末添加“当前阅读路径上一篇 / 下一篇”,或列出相关主题。使用真实已发布的目标;首篇、末篇不制造不存在的相邻文章。