atom启动时自动执行init.coffee或init.js，需通过菜单栏“open your init script”打开编辑，改完必须重启生效；最常见用途是修改process.env.path以解决插件找不到命令的问题。
怎么打开并编辑 init.coffee 或 init.js
Atom 启动时会自动执行 init.coffee（CoffeeScript）或 init.js（JavaScript），这是你做全局初始化操作的唯一入口。它不像普通配置文件那样靠设置界面修改，必须手动编辑。
打开方式只有一种可靠路径：菜单栏 → Atom → Open Your Init Script（macOS）或 File → Open Your Init Script（Windows/Linux）。用快捷键 Cmd+Shift+P / Ctrl+Shift+P 搜 Open Your Init Script 也行，但别依赖模糊匹配——有时插件名冲突会导致打开错文件。
- 首次打开时，如果没建过，Atom 会自动创建空的
init.coffee - 想用 JavaScript？删掉
init.coffee，新建init.js并保存，Atom 下次启动就执行它 - 改完必须重启 Atom 才生效——热重载不支持 init 脚本
为什么改 process.env.PATH 是最常见需求
很多插件（比如 script）运行 Python、Node 或其他命令时，依赖系统 PATH 找解释器。如果你装的是 Anaconda、pyenv、nvm 管理的环境，或者 Python 不在默认路径（如 /usr/bin/python），script 插件就会报 command not found: python 或直接闪退。
解决方法是在 init.coffee 末尾加一行，把你的环境路径“塞”到最前面：
process.env.PATH = ['/opt/anaconda3/bin/', process.env.PATH].join(':')
注意几个关键点：
-
process.env.PATH是字符串，不是数组；用.split(':')再.join(':')是安全写法，但简单追加时直接拼接也行 - 路径末尾要带斜杠
/，否则可能变成/opt/anaconda3/binpython这种错误路径 - macOS 和 Linux 用冒号
:分隔；Windows 用分号;，但 Atom 在 Windows 上跑 CoffeeScript 时仍建议统一用:（Electron 层做了兼容） - 别写成
process.env.PATH += ':/path/to/bin'——这会污染原始值，且多次重启后 PATH 越来越长
init.coffee 里写什么才真正有用
很多人把 init 脚本当成“能塞代码的地方”，结果堆了一堆无效逻辑。其实它只适合三类操作：改环境变量、监听 Atom 生命周期事件、调用已激活包的命令。
例如你想让 Atom 启动时自动聚焦第一个编辑器，可以写：
atom.applicationDelegate.onDidFinishLaunching -> atom.workspace.getActivePaneItem()?.focus()
但要注意：
- 所有代码必须在 Atom 完全加载后执行，所以要用
atom.applicationDelegate.onDidFinishLaunching或atom.packages.onDidActivatePackage包监听，不能裸写atom.commands.dispatch - 不要在 init 里 require 未安装的模块，会静默失败；也不要用
fs.readFileSync读大文件，阻塞主线程 - 调试靠
console.log，输出在开发者工具控制台（Cmd+Alt+I），不是脚本插件的输出面板 - 如果某段代码导致 Atom 启动卡死或白屏，删掉
init.coffee再重启即可恢复
乱码、报错、命令不生效？先查这三处
按 Ctrl+Shift+B 运行 Python 却看到一堆乱码、 符号，或者提示 python: command not found，大概率不是 script 插件问题，而是 init 配置没生效或路径不对。
- 确认你改的是
~/.atom/init.coffee（macOS/Linux）或%USERPROFILE%\.atom\init.coffee（Windows），而不是某个项目里的同名文件 - 在终端里执行
which python或where python，复制**完整路径的父目录**（比如which python输出/opt/anaconda3/bin/python，你就填/opt/anaconda3/bin/） - 如果用了虚拟环境，别填 venv 的
bin/目录——它每次激活才生效；应该填 base conda 路径，或在 init 里用process.env.CONDA_DEFAULT_ENV做条件判断（较复杂，慎用）
init 脚本不是万能胶，它只影响 Atom 进程自身的环境变量。Terminal 插件（如 platformio-ide-terminal）是否继承这个 PATH，取决于插件自身实现——有些会，有些不会。这点容易被忽略，但很关键。
