# admin_gw

**Repository Path**: daidai0/admin_gw

## Basic Information

- **Project Name**: admin_gw
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-12
- **Last Updated**: 2026-01-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Vue 3 + Vite + vite-ssg

This project is built with Vue 3, Vite, and vite-ssg for static site generation. The template uses Vue 3 `<script setup>` SFCs, check out the [script setup docs](https://v3.vuejs.org/api/sfc-script-setup.html#sfc-script-setup) to learn more.

Learn more about IDE Support for Vue in the [Vue Docs Scaling up Guide](https://vuejs.org/guide/scaling-up/tooling.html#ide-support).

## 快速开始

### 安装依赖

```bash
npm install
```

### 运行开发服务器

启动开发服务器，默认监听 5173 端口：

```bash
npm run dev
```

### 构建生产版本

构建静态站点到 `dist` 目录：

```bash
npm run build
```

或使用别名命令：

```bash
npm run generate
```

### 预览构建结果

在本地预览构建后的静态站点：

```bash
npm run preview
```

## 部署

### 静态站点部署

由于项目使用 vite-ssg 构建为静态站点，你可以将 `dist` 目录部署到任何静态网站托管服务：

#### 常用部署选项

1. **Gitee Pages**
   - 在 Gitee 上创建一个新仓库
   - 将本地项目推送到 Gitee 仓库：
     ```bash
     git remote add origin https://gitee.com/your-username/repo-name.git
     git add .
     git commit -m "Initial commit"
     git push -u origin main
     ```
   - 构建项目：`npm run build`
   - 推送 `dist` 目录到 Gitee 仓库（两种方式）：
     - **方式一：直接推送 dist 目录**
       ```bash
       cd dist
       git init
       git remote add origin https://gitee.com/your-username/repo-name.git
       git add .
       git commit -m "Deploy"
       git push -f origin master:gh-pages
       cd ..
       ```
     - **方式二：使用 git subtree**
       ```bash
       git subtree push --prefix dist origin gh-pages
       ```
   - 在 Gitee 仓库的「服务」->「Gitee Pages」中配置：
     - 选择分支：`gh-pages`
     - 选择目录：`/`（根目录）
     - 点击「启动」
   - 等待部署完成，访问分配的域名

2. **GitHub Pages**
   - 构建项目：`npm run build`
   - 将 `dist` 目录内容推送到 GitHub 仓库的 `gh-pages` 分支
   - 在仓库设置中启用 GitHub Pages

3. **Vercel / Netlify**
   - 连接你的 Git 仓库
   - 配置构建命令：`npm run build`
   - 配置输出目录：`dist`
   - 部署将自动触发

4. **Nginx / Apache**
   - 构建项目：`npm run build`
   - 将 `dist` 目录内容复制到服务器的网站根目录
   - 配置 Nginx / Apache 指向该目录

#### 部署注意事项

- 确保在构建前配置正确的 `base` 路径（在 `vite.config.js` 中设置）
- 对于单页应用 (SPA) 模式，确保服务器配置了 fallback 路由（指向 `index.html`）
- 静态站点生成模式下，每个路由都会生成对应的 HTML 文件，无需特殊配置
- 如果部署到 Gitee Pages 的子路径（如 `https://your-username.gitee.io/repo-name/`），需要在 `vite.config.js` 中设置 `base: '/repo-name/'`

## 项目结构

```
├── public/          # 静态资源目录
├── src/             # 源代码目录
│   ├── components/  # Vue 组件
│   ├── pages/       # 页面组件
│   ├── router/      # 路由配置
│   ├── App.vue      # 根组件
│   └── main.ts      # 入口文件
├── dist/            # 构建输出目录
├── vite.config.ts   # Vite 配置
└── package.json     # 项目配置
```