Node.js、包管理与 Git

Node.js 是什么

浏览器里的 JavaScript 负责页面交互；Node.js 让 JavaScript 也能在电脑或服务器上运行，因此可以用来执行构建、开发服务器、脚本和后端程序。

Node.js 不是某个前端框架，也不是“安装了就自动有数据库”。它是运行时，项目还会选择框架、依赖和数据服务。

package.json 通常记录项目名称、脚本、依赖和版本范围。npm、pnpm、Yarn、Bun 都可以管理依赖，但同一个项目应遵循它已有的锁文件和团队约定。

常见命令（以 npm 为例）：

npm install       # 安装项目依赖
npm run dev       # 启动开发环境（具体脚本以项目为准）
npm run build     # 构建生产文件
npm run test      # 运行测试（如果项目提供）

不要看到一个报错就随意升级所有依赖。先记录 Node 版本、包管理器、完整错误和最近改动。

Git 会记录文件变化，让你可以比较、回退和协作。最小工作循环是：

修改 → 查看 diff → 检查/测试 → 提交一个清楚的版本

常用命令：

git status
git diff
git add <文件>
git commit -m "说明这次修改"

提交前检查 git diff，确认没有把 .env、密钥、构建产物或无关文件带进去。

把运行命令、目录结构、代码风格和禁止事项写进项目说明文件；让 Agent 先读取它。要求它只修改任务范围，并在结束时报告 git diff --stat、检查命令和结果。