wrap-guide.columns必须为数组格式,如[80],写成80或"80"均无效;它仅控制参考竖线位置,与editor.preferredlinelength功能独立。

wrap-guide.columns 必须是数组,写成 80 或 "80" 都不生效
那条竖线不是“错误提示”,而是 wrap-guide 插件渲染的参考线,它的位置由 wrap-guide.columns 控制——但这个配置项只接受数组。即使你只想设一个宽度,也必须写成 [80],否则插件直接忽略该值,继续用默认(通常是 80,但不可靠)。
常见错误操作:
- 在
config.cson里写columns: 80→ 不显示竖线 - 写成
columns: "80"→ 同样无效,控制台可能报类型警告 - 漏掉
wrap-guide区块,直接挂在editor下 → 插件完全收不到配置
正确写法(config.cson):
"wrap-guide": columns: [80]
editor.preferredLineLength 和 wrap-guide.columns 是两套系统
editor.preferredLineLength 影响软换行、linter 警告、代码格式化工具(如 rustfmt、clang-format)的行宽判断;而 wrap-guide.columns 只决定竖线是否画、画在哪。两者可以不同,但通常建议保持一致,否则你会看到竖线在 80,而 linter 却在 79 报错。
典型脱节场景:
-
editor.preferredLineLength: 79,但wrap-guide.columns: [120]→ 竖线偏右,误以为“还能多写” - 项目用了
.rustfmt.toml设max_width = 100,但竖线还在 80 → 视觉干扰,容易手动折行破坏格式化规则 - JSON 文件想放宽到 120,但
wrap-guide.columns不支持语言级配置 → 只能全局设成[120],或改用 CSS 隐藏后靠编辑器软换行感知边界
竖线变红/加粗必须用 !important 覆盖主题样式
Atom 主题(如 one-dark-ui)会用自己的 CSS 规则控制 .wrap-guide 的颜色和粗细,直接在 styles.less 里写:
.wrap-guide {
border-left: 2px solid #ff4444 !important;
}
不加 !important 几乎一定被覆盖,尤其在启用深色主题时,原生灰线可能根本看不见。另外注意选择器是 .wrap-guide,不是 .atom-text-editor .wrap-guide 或其他嵌套写法——插件注入的伪元素层级很浅,过度限定反而失效。
如果只想隐藏它(比如专注阅读不关心边界):
.wrap-guide {
visibility: hidden !important;
}
改完配置不显示?先热重载,再换文件标签页
wrap-guide 插件有个顽固特性:配置更新后,已打开的文件标签页不会自动刷新竖线。不是 bug,是设计如此。
快速验证步骤:
- 按
Ctrl+Alt+R(Windows/Linux)或Cmd+Alt+R(macOS)执行Window: Reload,不是关窗口重开 - 切换到另一个文件标签页(哪怕新建一个
Untitled),再切回来 - 用纯文本(
.txt)测试:输入一长行超 100 字符,排除语法高亮干扰 - 临时切到
atom-light主题,确认是否是当前主题 CSS 隐藏了竖线
最常被忽略的一点:插件本身可能没装上。终端运行 apm list --installed | grep wrap,必须看到类似 wrap-guide@1.6.2 的输出,否则所有配置都是空谈。










