Atom的wrap-guide插件默认禁用,需在Settings→Install中搜索并启用;启用后须配置editor.preferredLineLength(如80)和wrap-guide.columns: [80],且需重启或重载窗口才生效。

Atom 的 wrap-guide 插件默认已内置,但不会自动显示——必须手动启用并配置列宽,否则你看到的只是“没反应”。
如何确认 wrap-guide 已启用
Atom 1.0+ 版本自带 wrap-guide,但默认处于禁用状态。打开设置(Atom → Preferences 或 Ctrl+,),左侧选 Install,在搜索框输入 wrap-guide,检查其右侧是否显示 Enabled。若显示 Disable,说明已启用;若显示 Enable,点它激活。
- 禁用状态时,即使设置了
editor.preferredLineLength,也不会出现竖线 - 启用后不立即生效,需重启编辑器或切换一次文件标签页
- 某些主题(如
one-dark-ui)可能让参考线颜色过淡,需后续调色
设置列宽数值:改哪里?
列宽由两个独立配置项共同决定:editor.preferredLineLength 控制位置,wrap-guide.columns 控制是否按该值显示。前者是编辑器级设置(影响软换行、linter 提示等),后者是 wrap-guide 插件专属开关。
- 推荐在
Atom → Config...(即config.cson)中添加:
"editor": "preferredLineLength": 80 "wrap-guide": "columns": [80]
columns 必须是数组,即使只设一个值也要写成 [80],写成 80 或 "80" 都无效language-specific-configs,但 wrap-guide 本身不支持语言级 column 切换参考线不显示?常见原因和验证步骤
最常踩的坑不是配置错,而是“以为配置了就该立刻出现”。先做三件事快速定位:
- 打开一个纯文本文件(如
.txt),输入超长行(>100 字符),看是否有竖线——排除语法高亮或语言包干扰 - 检查当前主题是否隐藏了 guide:临时切换到
atom-light主题,再试 - 运行
Window: Reload(Ctrl+Alt+R),而不是仅关闭重开窗口——插件配置有时需热重载 - 终端里执行
apm list --installed | grep wrap,确认输出含wrap-guide@*,避免被误删
颜色和样式能自定义吗?
不能通过设置界面调,但可直接改 styles.less(Atom → Styles... )。参考线本质是伪元素 ::after,CSS 选择器为 .wrap-guide。
- 加粗/变红示例:
.wrap-guide {
border-left: 2px solid #ff4444 !important;
}
!important,否则被主题 CSS 覆盖border-style: dashed 渲染异常,导致断续或消失真正麻烦的是:当你在多个项目间切换,而每个项目要求不同列宽(比如团队规范分别是 80 / 100 / 120),wrap-guide 没有项目级配置能力,只能靠手动切 config.cson 或用第三方包(如 project-manager 配合脚本),这点容易被忽略。

















