vscode 启动后找不到 node 命令的根本原因是未继承 shell 初始化后的 path；log4js 日志不写入文件多因目录未创建或路径配置错误；调试控制台不显示日志因默认不捕获 stdout，需配置 "outputcapture": "std" 或改用集成终端。
VSCode 启动后找不到 node 命令
根本原因不是 Node 没装，而是 VSCode 没拿到 shell 初始化后的 PATH。你在终端里能跑 node -v，但 VSCode 的集成终端或调试器报 command not found: node，基本就是这个路径继承问题。
macOS / Linux：检查 ~/.zshrc 或 ~/.bash_profile 是否有类似 export PATH="/usr/local/bin:$PATH"（Homebrew 安装路径）；Windows：确认安装 Node.js 时勾选了 Add to PATH，没勾的要么重装，要么手动把 C:\Program Files\nodejs\ 加进系统环境变量。
重启 VSCode 前，务必关掉所有窗口，再从命令行启动：code --no-sandbox（macOS）或直接双击图标（Windows），避免继承旧 shell 环境。
log4js 配置后日志不写入文件
常见现象是控制台有输出，但 logs/ 目录下始终空着，甚至目录都没创建出来。这通常是因为配置中指定了路径但没提前建好父目录，或权限不足。
- 确保项目根目录下已手动创建
logs文件夹，并加到.gitignore中 -
dateFile类型的 appender 必须指定完整路径，推荐用path.resolve(__dirname, '../../logs/xxx.log')而非相对路径 - 检查
filename字段是否拼错，比如漏了扩展名.log，或路径里用了反斜杠\（Windows 下也要用正斜杠/或path.join） - 若用
maxLogSize+backups，首次写入会先尝试读取已有日志，路径不存在时可能静默失败——可先注释掉这两个字段验证基础写入是否正常
调试时 log4js 输出在 VSCode 调试控制台不可见
VSCode 默认的 debug console 不捕获 process.stdout 流，而 log4js 的文件和控制台 appender 都走这个流。所以你看到日志“消失了”，其实它只是没被调试控制台抓取。
两个有效解法：
- 在
launch.json的配置项里加一行："outputCapture": "std"，强制调试器捕获 stdout/stderr - 或者改用集成终端运行：
"console": "integratedTerminal"，这样日志会原样输出到终端，且支持颜色
注意："console": "internalConsole"（默认）依然不会显示 log4js 文件输出，它只显示 console.* 和部分调试器原生输出。
日志文件按小时滚动但内容重复或截断
用 dateFile 并设 pattern: "-yyyy-MM-dd-hh.log" 本意是每小时一个文件，但实际常出现：同一小时多个进程写入冲突、文件大小远小于 maxLogSize 就切新文件、甚至日志行被截断。
核心问题是 log4js 默认不加锁，多实例并发写会出问题。本地开发单进程一般没问题，但一旦涉及 nodemon 重启、npm run dev 多任务，就容易踩坑：
- 开发期建议先禁用
maxLogSize和backups，专注验证路径与内容正确性 - 若必须滚动，改用
file类型配合numBackups（更稳定），或升级到log4js@6.9+后启用keepFileExt和alwaysIncludePattern: true - 避免在
app.js入口多次调用log4js.configure()，会导致 appenders 被重复注册，引发写入混乱
最易被忽略的是：log4js 的配置对象一旦传给 configure()，后续就不能靠改 JS 变量来热更新——改完必须重启进程才生效。
