Atom需配置atom-ternjs插件并手动创建.minimal .tern-project文件，含"ecmaVersion":6、"loadEagerly":["/.js","node_modules/express//.js"]、"plugins":{"node":{},"express":{}}等字段，且修改后须手动Restart server。

Atom 本身不内置 Express 支持，写 Express 项目的关键不是“Atom 怎么写”，而是「怎么让 Atom 正确识别 Node.js + Express 的语法、补全和运行逻辑」。核心障碍在 atom-ternjs 插件的配置——它决定你敲 app. 后能不能弹出 get、use、listen 等方法提示，以及跳转定义是否准确。

为什么装了 atom-ternjs 还没补全？

常见现象：安装完 atom-ternjs，新建 app.js，输入 const express = require('express'); 后，express(). 没提示，或 app. 只有基础 JS 方法，没有 Express 特有方法。

• 根本原因：默认配置不加载 Express 插件，也不解析 node_modules/express 中的类型定义
• .tern-project 文件必须手动创建在项目根目录（与 package.json 同级），不能靠插件界面自动生成全部字段
• Mac 用户尤其容易漏掉 loadEagerly 字段，导致插件根本不扫描 node_modules 下的文件
• Windows 或 Mac 上若用全局安装的 express-generator 创建项目，生成的 app.js 里 require('express') 路径是动态的，tern 需要明确知道从哪找类型声明

.tern-project 文件必须包含哪些字段？

一份能支持 Express 补全的最小可用配置如下，直接复制进项目根目录的 .tern-project：

dmap-jsapi-skill

DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。

下载

{
  "ecmaVersion": 6,
  "libs": ["browser"],
  "loadEagerly": ["**/*.js", "node_modules/express/**.js"],
  "dontLoad": ["node_modules/**/test/**", "node_modules/**/example/**"],
  "plugins": {
    "node": {},
    "express": {}
  }
}

注意几个关键点：

• "express": {} 是必需的——atom-ternjs 官方支持该插件，但插件界面不提供勾选，必须手写
• loadEagerly 显式包含 node_modules/express/**.js，否则 tern 默认跳过整个 node_modules
• 如果项目用了 express@5+（ESM 默认），需确认 ecmaVersion 至少为 2022，否则 import 语句会报错干扰补全
• 删掉 libs 里的 "jquery" 或其它无关项，避免加载冲突或拖慢启动

运行 Express 项目别依赖 script 插件

script 插件快捷键（ctrl+shift+b）只能执行单个 JS 文件，但 Express 项目通常靠 npm start 启动，且需要监听端口、热重载、环境变量等支持。

• 直接在 Atom 内置终端（ctrl+`）中运行 npm start 更可靠，错误日志可点击跳转
• 不要把 bin/www 当作入口直接运行——它依赖 app.js 导出的 app 实例，单独执行会报 Cannot find module './app'
• 若想一键重启，可安装 atom-live-server，但它不适用于 Express；更实用的是配置 nodemon：npm install --save-dev nodemon，然后改 package.json 的 "scripts": {"dev": "nodemon ./bin/www"}
• 调试时别用 console.log 海投——配合 node-debug 或 VS Code 的调试器更高效，Atom 原生调试支持已基本废弃

最常被忽略的一点：每次修改 .tern-project 后，必须手动触发 Packages > Atom Ternjs > Restart server，否则改动完全不生效。这个操作没有自动监听，也没有状态提示，很多人改完就以为好了，实际补全还是旧的。