Atom欢迎界面不可定制,因其由welcome包硬编码生成,不继承config.cson或styles.less配置;唯一可行方案是禁用welcome并安装可配置的home插件,通过~/.atom/home.md以Markdown自定义内容。

Atom 的欢迎界面(Welcome Screen)本身不支持直接配置显示内容,它由 welcome 官方包硬编码生成,所有文案、链接、按钮逻辑都写死在源码里;你无法通过 settings、config.cson 或 UI 开关修改它显示“最近打开的文件”或“自定义提示语”。
为什么改 config.cson / styles.less 都没用
欢迎界面是独立的 atom-text-editor 实例,运行在隔离的上下文中,不继承主编辑器的配置项(如 editor.fontSize)或样式变量(如 @syntax-color-string)。即使你在 styles.less 里写 .welcome .header { display: none; },也只会让标题消失,但不会替换成你的内容——因为 DOM 结构由 welcome 包的 CoffeeScript 模板控制,不是 CSS 可覆盖的。
- 欢迎界面的 HTML 模板路径是
node_modules/welcom/package/lib/welcome-view.coffee,修改它属于破坏性 patch,每次apm update都会被重置 -
config.cson中的"welcome.showOnStartup": false只能开关整个界面,不能定制其内容 - 试图用
atom.packages.onDidActivatePackage监听welcome激活后操作 DOM,会因渲染时机问题失败:DOM 尚未挂载完成,document.querySelector('.welcome')返回null
真正可行的替代方案:禁用 welcome + 启用替代插件
目前唯一稳定、可维护的做法是停用原生 welcome,换用社区维护的可配置替代品。截至 2026 年 7 月,home 插件(作者:nathanhoad)仍活跃更新,支持 Markdown 渲染和 config.cson 驱动的内容:
- 先禁用内置 welcome:Settings → Packages →
welcome→ Disable - 安装
home:Settings → Install → 搜索home→ Install - 在
config.cson中添加配置块:"home": "markdownPath": "~/.atom/home.md" "autoOpen": true - 创建
~/.atom/home.md文件,写任意 Markdown(支持代码块、表格、图片),保存后重启 Atom 即生效
想完全隐藏欢迎页?别只关开关
仅设置 "welcome.showOnStartup": false 不够——某些场景下(如首次启动、无文件打开时)Atom 仍会强制弹出 welcome。必须配合以下两步才彻底屏蔽:
- 在 Settings → Core → Auto Hide Title Bar 勾选(部分 Linux 桌面环境需此操作才能抑制 welcome 弹窗)
- 运行命令
application:open-folder或core:open-file替代直接双击 Atom 图标启动,避免进入“无项目”状态 - 若用终端启动,加
--no-welcome参数:atom --no-welcome .(该 flag 自 v1.65 起稳定支持)
欢迎界面的不可定制性不是疏忽,而是 Atom 架构设计使然:它被当作一个“引导性只读视图”,而非可扩展 UI 组件。任何试图绕过插件机制直接注入内容的操作,都会在升级后失效,且容易引发渲染冲突。真要个性化,就老老实实走 home 这条路——它用标准 Atom API 实现,不 hack 渲染流程,升级兼容性有保障。

















