# Git 配置优化：忽略静态文件，提交依赖目录

## 1。背景

在好站站企业建站引擎的开发过程中，需要合理配置 `.gitignore` 文件，以达到以下目标：

1. **方便用户一键安装**：`/vendor` 目录提交到 Git，用户无需执行 `composer install`
2. **避免冲突**：`/public/*.html` 静态文件不提交，每个用户安装后独立生成

---

## 2。最终 `.gitignore` 配置

```gitignore
/.phpunit.cache
/node_modules
/public/build
/public/hot
/public/storage
/storage/*.key
/storage/install.lock
/storage/pail
.env
.env.backup
.env.production
.phpactor.json
.phpunit.result.cache
Homestead.json
Homestead.yaml
npm-debug.log
yarn-error.log
/auth.json
/.fleet
/.idea
/.nova
/.vscode
/.zed

# 忽略静态生成的 HTML 文件
/public/*.html
```

---

## 3。配置说明

| 文件/目录 | 是否提交 | 原因 |
|-----------|---------|------|
| `/vendor` | ✅ 提交 | 用户无需 composer install，一键安装 |
| `/node_modules` | ❌ 忽略 | 体积大，用户自行 npm install |
| `/public/*.html` | ❌ 忽略 | 安装后一键生成，避免冲突 |
| `.env` | ❌ 忽略 | 安装时自动创建 |
| 其他源码 | ✅ 提交 | 正常版本控制 |

---

## 4。操作步骤

### 4.1 编辑 `.gitignore`

```bash
code .gitignore
```

### 4.2 替换内容

将上述配置复制到文件中，保存。

### 4.3 提交变更

```bash
git add .gitignore
git commit -m "chore: 忽略 public/*.html，提交 vendor 目录"
git push origin main
```

---

## 5。验证结果

| 验证项 | 预期结果 | 实际结果 |
|--------|---------|---------|
| `vendor/` 目录 | 推送到远程仓库 | ✅ |
| `public/*.html` | 不被 Git 跟踪 | ✅ |
| 新用户克隆后 | 可直接使用 | ✅ |

---

## 6。提交记录

```bash
git add .gitignore
git commit -m "chore: 忽略 public/*.html，提交 vendor 目录"
git push origin main
```