在cursor中开发node.js项目应使用dotenv管理环境变量：根目录建.env文件写入键值对，入口文件顶部调用require('dotenv').config()；多环境用dotenv-cli或代码动态加载不同文件，并将生产文件加入.gitignore；终端临时设置仅当前会话生效；推荐通过.vscode/launch.json配置默认运行变量。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Cursor中开发Node.js项目时，必须让环境变量既能在本地调试时自动加载，又不随代码提交到远程仓库，否则API密钥、数据库密码等敏感信息极易泄露。
用dotenv加载本地.env文件
这是Cursor开发中最常用、最安全的环境变量管理方式，适用于开发和测试阶段。
第一步：在项目根目录创建名为 .env 的纯文本文件（注意开头是英文点号，不是 .env.txt）。
第二步：向 .env 文件中写入键值对，每行一个，等号两侧不加空格：
PORT=3001
DB_HOST=localhost
OPENAI_API_KEY=sk-xxx
第三步：在项目入口文件（如 index.js 或 app.js）的最顶部添加这一行代码：
require('dotenv').config();
这一步必须放在所有依赖 require() 之前，否则 process.env 中将读不到变量。如果项目使用 TypeScript，需先安装 @types/dotenv 并确保 ts-node 或构建流程能识别该模块。
区分开发/生产环境的变量文件
当项目需要对接不同数据库或服务地址时，靠手动切换 .env 内容容易出错，应使用多环境文件机制。
方法一：用 dotenv-cli 指定加载文件
安装命令：npm install --save-dev dotenv-cli
启动命令改为：
dotenv -e .env.dev node app.js
方法二：在代码中动态选择文件名
require('dotenv').config({ path: process.env.NODE_ENV === 'production' ? '.env.prod' : '.env.dev' });
【.env.prod 文件绝不能提交到 Git】，必须将其加入 .gitignore —— 否则生产密钥会直接暴露在仓库历史中，无法彻底删除。
诊断并恢复通过 SSH 隧道连接的 OpenClaw 节点。用于解决配对必需错误、隧道冲突、远程端点错误以及 SSH 目标配置错误等问题。
在Cursor终端中临时设置环境变量
适合快速验证某次运行是否受变量影响，不改变项目配置。
Windows（CMD）：set PORT=4000 & node app.js
Windows（PowerShell）：$env:PORT="4000"; node app.js
macOS/Linux：PORT=4000 node app.js
注意：这种设置只在当前终端会话生效，关闭终端即失效；且不会覆盖 .env 中已定义的同名变量（dotenv 默认不覆盖已有环境变量）。
通过Cursor设置默认运行配置（推荐）
避免每次都在终端敲命令，把常用变量固化进运行配置里，让F5调试一键生效。
① 在项目根目录创建 .vscode/launch.json（Cursor兼容VS Code调试配置）
② 添加以下配置片段：
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "Launch App",
"program": "${workspaceFolder}/app.js",
"env": {
"NODE_ENV": "development",
"PORT": "3001"
}
}
]
}
这个配置会在每次点击“运行 → 启动调试”时，自动注入 env 字段中的变量。它优先级高于 .env 文件，但不会写入磁盘，也不参与版本控制。
