PhpStorm行号不显示的解决方法是勾选Settings→Editor→General→Appearance中的Show line numbers选项,注意检查项目设置覆盖、Zen模式、主题颜色及DPI缩放等干扰因素。
PhpStorm 行号不显示?检查 Settings → Editor → General 里的开关
行号默认是开启的,但很多人装完插件、导入设置或重装后发现没了,大概率是 show line numbers 被手动关了。这不是 bug,是 phpstorm 尊重你的选择——哪怕你根本没意识到自己点过。
操作路径很直接:File → Settings(macOS 是 PhpStorm → Preferences)→ Editor → General,往下拉到 Appearance 区域,勾选 Show line numbers 即可。
- 这个选项只影响当前项目的编辑器视图,不影响其他项目(除非你改的是 Default Settings)
- 如果勾选后仍不显示,先确认没在某个文件里误启了「Zen Mode」或「Distraction Free Mode」——这两种模式会强制隐藏所有 UI 元素,包括行号
- 部分老旧主题(比如某些自定义 Darcula 变体)可能把行号颜色设成和背景一致,看起来像“没显示”,实际开了。可以临时切回默认
IntelliJ Light或Dark Theme排查
想让行号只在特定语言里显示?用 Language Injections 或 File Type 绑定不现实
PhpStorm 没有按文件类型开关行号的功能。Show line numbers 是全局编辑器级开关,对所有打开的文本文件生效(.php、.js、.json、甚至 .log),没法单独给 PHP 开、给 Markdown 关。
如果你真需要“视觉隔离”,可行的折中方案只有两个:
- 用
Editor → Color Scheme → General → Line numbers调整行号颜色或透明度,让非主力语言的行号“弱化”一点 - 在写 Markdown 或 JSON 时,手动启用
View → Appearance → Hide Line Numbers(临时关闭),但这不是持久设置,重启编辑器就恢复原状
别折腾插件或 XML 配置试图实现 per-file-type 控制——目前没有稳定支持,且容易和后续版本升级冲突。
立即学习“PHP免费学习笔记(深入)”;
行号右边那个小竖线(gutter)总被误当成“行号的一部分”
很多人以为 gutter 里的断点、折叠箭头、VCS 修改标记(蓝色条/绿色圆点)属于行号区域,其实它们是独立的 UI 层。行号本身只是左侧一列数字,宽度固定,不随 gutter 内容变化。
如果你发现行号和代码之间空隙过大,或者数字右对齐异常,问题通常出在:
-
Settings → Editor → Font中启用了Use color font to display emoji(尤其 Windows 上),可能导致字体渲染错位,连带影响行号排版 - 安装了修改 editor gutter 的插件(如
GitToolBox或CodeGlance),它们有时会抢占 gutter 宽度,挤压行号显示空间 - 系统 DPI 缩放设置非 100%(特别是高分屏 Win/mac),而 PhpStorm 启动时未正确读取,导致 UI 元素错位;可尝试在启动脚本里加
-Dsun.java2d.uiScale=1
为什么改了 Settings 没立刻生效?缓存和配置作用域容易混淆
改完 Show line numbers 立刻生效是常态,但如果你在多个地方改过,可能会遇到“改了却没变”的情况。核心原因是 PhpStorm 的配置分三层:
-
Default Settings:新项目默认继承,不影响已打开项目 -
Project Settings:当前项目独有,重启项目才加载(不是重启 IDE) -
IDE Settings:全局生效,但仅限未被项目覆盖的部分
最常踩的坑是:你在 Default Settings 里开了行号,但当前项目早就在 Project Settings 里关了——这时改 Default 没用,得进该项目的 Settings 单独开。
快速验证方式:打开一个刚新建的空白项目,看行号是否显示。如果是,说明你的 Project Settings 被动过;如果不是,再查 IDE 启动参数或插件干扰。
行号这事本身很简单,麻烦在于它太靠底层,一旦和其他 UI 设置、插件、系统渲染链耦合,排查路径就容易发散。盯住 Show line numbers 这个开关本身,再确认作用域和模式状态,基本就能闭环。

















