Sublime怎么写更新日志_Sublime如何编辑Changelog文件【详解】-sublime-PHP中文网

sublime中changelog文件需手动或配置关联markdown语法高亮；可用snippet快速插入规范版本条目；markdown preview需启用toc扩展支持锚点跳转；保存时可用conventional-changelog-lint校验格式合规性。

sublime怎么写更新日志_sublime如何编辑changelog文件【详解】

Changelog 文件该用什么语法高亮

Sublime 默认不会把 CHANGELOG.md 或 changelog.md 当作 Markdown 处理，导致标题、列表、代码块全无样式，写起来像纯文本。这不是 bug，是 Sublime 的文件名匹配规则没覆盖常见变体。

手动切换语法：右下角点击当前语法名（比如 “Plain Text”），在弹出菜单里选 Markdown；或者按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Set Syntax: Markdown 回车。

一劳永逸的办法是配置文件关联：

打开 Preferences → Settings – Syntax Specific

粘贴这段 JSON：

{
  "extensions": ["changelog.md", "CHANGELOG.md", "Changelog.md"],
  "syntax": "Packages/Markdown/Markdown.sublime-syntax"
}

保存后，所有匹配的文件自动用 Markdown 语法高亮

怎么快速插入符合规范的版本条目

手敲 ## [1.2.3] - 2024-06-15 这类标题既慢又容易格式错位。Sublime 没内置 Changelog 模板，但可以用 Snippet 补上这个缺口。

新建 Snippet：Tools → Developer → New Snippet…，填入内容：

<snippet><content>Added<ul><li></ul>
<h3>Changed</h3>
<ul><li></ul>
<h3>Fixed</h3>
<ul><li>]]></li></ul></content><tabtrigger>chlog</tabtrigger><scope>text.html.markdown</scope></snippet>

保存为 changelog.sublime-snippet（路径无所谓，Sublime 会自动加载）。之后在 Markdown 文件里输入 chlog 再按 Tab，就能生成带日期和分类的空条目。

${1:1.0.0} 是占位符，光标会停在这儿，方便你直接改版本号
${2:`strftime(...)`} 调用 Python 的 strftime，实时生成当天日期
<scope>text.html.markdown</scope> 确保只在 Markdown 文件中触发，避免误用

为什么用 Markdown Preview 插件预览时链接不跳转

很多人装了 MarkdownPreview 插件，但点 [v1.2.0](#120) 这种锚点链接没反应——不是插件坏了，是默认渲染器（Python-Markdown）不启用 toc 扩展，导致标题没生成 ID。

Cutout.Pro抠图

一款提供AI自动抠图和背景移除能力的图片处理工具，可快速提取人物、商品等主体并支持批量处理视觉素材。

下载

要让锚点生效，得改插件配置：

打开 Preferences → Package Settings → Markdown Preview → Settings

在用户设置里加这段：

"markdown_extensions": [
  "toc",
  "fenced_code",
  "tables"
]

重启预览（快捷键 Ctrl+Shift+P → Markdown Preview: Preview in Browser）

注意：toc 扩展会给每个标题自动加 id，比如 ## [1.2.0] 变成 <h2 id="_120">[1.2.0]</h2>，这样 [v1.2.0](#_120) 才能跳转。

Git 提交前怎么检查 Changelog 格式是否合规

靠人眼扫 Unreleased 段落有没有漏写、日期对不对，效率低还容易漏。Sublime 本身不提供校验，但可以借力命令行工具，在保存后自动跑一次检查。

推荐用 conventional-changelog-lint（简称 ccl），它专检 Conventional Changelog 格式：

全局安装：npm install -g conventional-changelog-lint
在项目根目录建 .commitlintrc.json，内容至少含：
```
{"extends": ["@commitlint/config-conventional"]}
```
配合 Sublime 的 SublimeOnSaveBuild 插件，在保存 CHANGELOG.md 时自动执行：ccl --from=HEAD~1 --to=HEAD

错误会直接显示在 Sublime 底部状态栏，比如 error: subject may not be empty [subject-empty]。别指望它查拼写或语序，它只管结构合规性。

真正难的是语义一致性：比如一个“Fixed”条目到底该归到哪个版本、要不要拆成多个 commit——这些没法靠工具判断，得靠团队约定和人工 review。