提交信息
This commit is contained in:
commit
be53ff00c0
5
.env.development
Normal file
5
.env.development
Normal file
@ -0,0 +1,5 @@
|
|||||||
|
# .env.development (开发环境)
|
||||||
|
VITE_API_BASE_URL = 'http://localhost:3000/api'
|
||||||
|
|
||||||
|
# .env.production (生产环境)
|
||||||
|
VITE_API_BASE_URL = 'https://your-api-domain.com/api'
|
||||||
7
.eslintignore
Normal file
7
.eslintignore
Normal file
@ -0,0 +1,7 @@
|
|||||||
|
# .eslintignore
|
||||||
|
node_modules
|
||||||
|
dist
|
||||||
|
public
|
||||||
|
*.d.ts
|
||||||
|
.vscode
|
||||||
|
.husky
|
||||||
60
.eslintrc.cjs
Normal file
60
.eslintrc.cjs
Normal file
@ -0,0 +1,60 @@
|
|||||||
|
// .eslintrc.cjs
|
||||||
|
module.exports = {
|
||||||
|
root: true,
|
||||||
|
env: {
|
||||||
|
browser: true,
|
||||||
|
node: true,
|
||||||
|
es6: true,
|
||||||
|
},
|
||||||
|
extends: [
|
||||||
|
'eslint:recommended',
|
||||||
|
'plugin:vue/vue3-recommended', // Vue 3 推荐规则
|
||||||
|
'@vue/eslint-config-typescript', // TypeScript 支持
|
||||||
|
'prettier', // 关闭与 Prettier 冲突的规则（需先安装 prettier）
|
||||||
|
'plugin:prettier/recommended', // 将 Prettier 规则作为 ESLint 规则
|
||||||
|
],
|
||||||
|
parserOptions: {
|
||||||
|
ecmaVersion: 'latest',
|
||||||
|
sourceType: 'module',
|
||||||
|
ecmaFeatures: {
|
||||||
|
jsx: true,
|
||||||
|
},
|
||||||
|
},
|
||||||
|
rules: {
|
||||||
|
// 自定义规则（根据团队需求调整）
|
||||||
|
'vue/multi-word-component-names': 'off',
|
||||||
|
'prettier/prettier': 'error', // 将 Prettier 错误视为 ESLint 错误
|
||||||
|
// 强制使用 === 而非 ==
|
||||||
|
'eqeqeq': 'error',
|
||||||
|
|
||||||
|
// 组件 props 必须有类型和默认值
|
||||||
|
'vue/require-default-prop': 'error',
|
||||||
|
'vue/require-prop-types': 'error',
|
||||||
|
|
||||||
|
// 限制每行最大长度
|
||||||
|
'max-len': ['warn', {code: 120}],
|
||||||
|
|
||||||
|
// 禁止使用未定义的组件
|
||||||
|
'vue/no-unregistered-components': 'error',
|
||||||
|
|
||||||
|
// 组件名必须为 PascalCase
|
||||||
|
'vue/component-name-in-template-casing': ['error', 'PascalCase'],
|
||||||
|
|
||||||
|
// 禁止使用 v-html（防止 XSS）
|
||||||
|
'vue/no-v-html': 'warn',
|
||||||
|
// 自定义规则（根据团队需求调整）
|
||||||
|
'vue/multi-word-component-names': 'off', // 允许单字组件名
|
||||||
|
'no-console': process.env.NODE_ENV === 'production' ? 'warn' : 'off',
|
||||||
|
'no-debugger': process.env.NODE_ENV === 'production' ? 'error' : 'off',
|
||||||
|
'@typescript-eslint/no-unused-vars': ['warn', {argsIgnorePattern: '^_'}],
|
||||||
|
},
|
||||||
|
overrides: [
|
||||||
|
// 针对测试文件的规则
|
||||||
|
{
|
||||||
|
files: ['**/__tests__/*.{j,t}s?(x)', '**/tests/unit/**/*.spec.{j,t}s?(x)'],
|
||||||
|
env: {
|
||||||
|
jest: true,
|
||||||
|
},
|
||||||
|
},
|
||||||
|
],
|
||||||
|
}
|
||||||
24
.gitignore
vendored
Normal file
24
.gitignore
vendored
Normal file
@ -0,0 +1,24 @@
|
|||||||
|
# Logs
|
||||||
|
logs
|
||||||
|
*.log
|
||||||
|
npm-debug.log*
|
||||||
|
yarn-debug.log*
|
||||||
|
yarn-error.log*
|
||||||
|
pnpm-debug.log*
|
||||||
|
lerna-debug.log*
|
||||||
|
|
||||||
|
node_modules
|
||||||
|
dist
|
||||||
|
dist-ssr
|
||||||
|
*.local
|
||||||
|
|
||||||
|
# Editor directories and files
|
||||||
|
.vscode/*
|
||||||
|
!.vscode/extensions.json
|
||||||
|
.idea
|
||||||
|
.DS_Store
|
||||||
|
*.suo
|
||||||
|
*.ntvs*
|
||||||
|
*.njsproj
|
||||||
|
*.sln
|
||||||
|
*.sw?
|
||||||
5
.husky/pre-commit
Executable file
5
.husky/pre-commit
Executable file
@ -0,0 +1,5 @@
|
|||||||
|
#!/usr/bin/env sh
|
||||||
|
. "$(dirname -- "$0")/_/husky.sh"
|
||||||
|
|
||||||
|
npm test
|
||||||
|
npx lint-staged
|
||||||
5
.prettierignore
Normal file
5
.prettierignore
Normal file
@ -0,0 +1,5 @@
|
|||||||
|
# .prettierignore
|
||||||
|
node_modules
|
||||||
|
dist
|
||||||
|
public
|
||||||
|
*.d.ts
|
||||||
13
.prettierrc.cjs
Normal file
13
.prettierrc.cjs
Normal file
@ -0,0 +1,13 @@
|
|||||||
|
// .prettierrc.cjs
|
||||||
|
module.exports = {
|
||||||
|
printWidth: 120, // 每行最大字符数
|
||||||
|
tabWidth: 2, // 缩进空格数
|
||||||
|
useTabs: false, // 不使用制表符缩进
|
||||||
|
semi: false, // 句末不加分号
|
||||||
|
singleQuote: true, // 使用单引号
|
||||||
|
quoteProps: 'as-needed', // 对象属性仅在必要时加引号
|
||||||
|
trailingComma: 'none', // 不使用尾随逗号
|
||||||
|
bracketSpacing: true, // 对象括号内加空格
|
||||||
|
bracketSameLine: false, // HTML 标签的 > 不另起一行
|
||||||
|
arrowParens: 'avoid', // 箭头函数参数仅在必要时加括号
|
||||||
|
}
|
||||||
3
.vscode/extensions.json
vendored
Normal file
3
.vscode/extensions.json
vendored
Normal file
@ -0,0 +1,3 @@
|
|||||||
|
{
|
||||||
|
"recommendations": ["Vue.volar"]
|
||||||
|
}
|
||||||
250
README.md
Normal file
250
README.md
Normal file
@ -0,0 +1,250 @@
|
|||||||
|
# Vue 3 + TypeScript + Vite + Axios 基础框架
|
||||||
|
|
||||||
|
这是一个基于 **Vue 3**、**TypeScript** 和 **Vite** 的现代化前端基础框架，集成了 **Axios** 请求封装、**ESLint** 代码检查、**Prettier** 代码格式化等工具，帮助你快速搭建高质量的前端项目。
|
||||||
|
|
||||||
|
|
||||||
|
## 项目特性
|
||||||
|
|
||||||
|
- **核心框架**：Vue 3、Vue Router、Pinia（状态管理）
|
||||||
|
- **构建工具**：Vite 4（极速构建）
|
||||||
|
- **类型支持**：TypeScript 5（严格类型检查）
|
||||||
|
- **HTTP 请求**：Axios 封装（支持拦截器、错误处理、文件上传/下载）
|
||||||
|
- **代码规范**：ESLint + Prettier（统一代码风格）
|
||||||
|
- **样式方案**：Less（CSS 预处理）
|
||||||
|
- **提交规范**：Git 钩子（提交前自动检查代码）
|
||||||
|
|
||||||
|
|
||||||
|
## 快速开始
|
||||||
|
|
||||||
|
### 环境准备
|
||||||
|
|
||||||
|
- **Node.js**：v18+（推荐使用 [nvm](https://github.com/nvm-sh/nvm) 管理）
|
||||||
|
- **包管理器**：npm 或 pnpm
|
||||||
|
|
||||||
|
|
||||||
|
### 初始化项目
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 克隆仓库
|
||||||
|
git clone https://github.com/your-repo/vue3-ts-template.git
|
||||||
|
cd vue3-ts-template
|
||||||
|
|
||||||
|
# 安装依赖
|
||||||
|
npm install
|
||||||
|
|
||||||
|
# 启动开发服务器
|
||||||
|
npm run dev
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
### 主要命令
|
||||||
|
|
||||||
|
| 命令 | 描述 |
|
||||||
|
|-----------------|---------------------------------|
|
||||||
|
| `npm run dev` | 启动开发服务器 |
|
||||||
|
| `npm run build` | 构建生产环境包 |
|
||||||
|
| `npm run preview` | 预览生产环境包 |
|
||||||
|
| `npm run lint` | 代码检查并自动修复 |
|
||||||
|
| `npm run format` | 使用 Prettier 格式化代码 |
|
||||||
|
|
||||||
|
|
||||||
|
## 目录结构
|
||||||
|
|
||||||
|
```
|
||||||
|
src/
|
||||||
|
├── api/ # API 请求封装
|
||||||
|
├── assets/ # 静态资源
|
||||||
|
├── components/ # 通用组件
|
||||||
|
├── router/ # 路由配置
|
||||||
|
├── store/ # 状态管理 (Pinia)
|
||||||
|
├── utils/ # 工具函数
|
||||||
|
│ └── request.ts # Axios 封装
|
||||||
|
├── views/ # 页面组件
|
||||||
|
├── App.vue # 根组件
|
||||||
|
└── main.ts # 入口文件
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
## HTTP 请求封装
|
||||||
|
|
||||||
|
框架已封装完整的 Axios 请求工具，支持 **GET**、**POST**、**PUT**、**DELETE**、**文件上传** 和 **文件下载**，内置错误处理。
|
||||||
|
|
||||||
|
### 使用示例
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
import request from '@/utils/request'
|
||||||
|
|
||||||
|
// GET 请求
|
||||||
|
const fetchUsers = async () => {
|
||||||
|
try {
|
||||||
|
const res = await request.get('/api/users', { page: 1, limit: 10 })
|
||||||
|
console.log('用户列表:', res)
|
||||||
|
} catch (error) {
|
||||||
|
console.error('请求失败:', error)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// POST 请求
|
||||||
|
const createUser = async (data: any) => {
|
||||||
|
try {
|
||||||
|
const res = await request.post('/api/users', data)
|
||||||
|
console.log('创建成功:', res)
|
||||||
|
} catch (error) {
|
||||||
|
console.error('创建失败:', error)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 文件上传
|
||||||
|
const uploadFile = async (file: File) => {
|
||||||
|
try {
|
||||||
|
const res = await request.upload('/api/upload', file)
|
||||||
|
console.log('上传成功:', res)
|
||||||
|
} catch (error) {
|
||||||
|
console.error('上传失败:', error)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 文件下载
|
||||||
|
const downloadFile = async () => {
|
||||||
|
try {
|
||||||
|
await request.download('/api/download/report', null, '报告.pdf')
|
||||||
|
console.log('下载完成')
|
||||||
|
} catch (error) {
|
||||||
|
console.error('下载失败:', error)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
## 代码规范
|
||||||
|
|
||||||
|
### ESLint + Prettier
|
||||||
|
|
||||||
|
框架使用 ESLint 和 Prettier 统一代码风格，配置文件：
|
||||||
|
|
||||||
|
- `.eslintrc.cjs`：ESLint 规则
|
||||||
|
- `.prettierrc.cjs`：Prettier 规则
|
||||||
|
|
||||||
|
### 自动格式化
|
||||||
|
|
||||||
|
推荐在 VSCode 中安装以下插件，实现保存时自动格式化：
|
||||||
|
|
||||||
|
- ESLint
|
||||||
|
- Prettier
|
||||||
|
- Volar
|
||||||
|
|
||||||
|
|
||||||
|
## 状态管理
|
||||||
|
|
||||||
|
使用 **Pinia** 作为状态管理工具，示例：
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// store/userStore.ts
|
||||||
|
import { defineStore } from 'pinia'
|
||||||
|
import request from '@/utils/request'
|
||||||
|
|
||||||
|
export const useUserStore = defineStore('user', {
|
||||||
|
state: () => ({
|
||||||
|
userList: [],
|
||||||
|
loading: false,
|
||||||
|
error: null
|
||||||
|
}),
|
||||||
|
actions: {
|
||||||
|
async fetchUsers() {
|
||||||
|
this.loading = true
|
||||||
|
try {
|
||||||
|
const res = await request.get('/api/users')
|
||||||
|
this.userList = res
|
||||||
|
} catch (error) {
|
||||||
|
this.error = error
|
||||||
|
} finally {
|
||||||
|
this.loading = false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
})
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
## 部署
|
||||||
|
|
||||||
|
### 构建生产环境包
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm run build
|
||||||
|
```
|
||||||
|
|
||||||
|
构建后的文件会输出到 `dist` 目录。
|
||||||
|
|
||||||
|
|
||||||
|
### 部署到 GitHub Pages
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm run deploy
|
||||||
|
```
|
||||||
|
|
||||||
|
需先配置 `package.json` 中的 `homepage` 字段。
|
||||||
|
|
||||||
|
|
||||||
|
## 常见问题
|
||||||
|
|
||||||
|
### 1. Axios 请求拦截器类型错误
|
||||||
|
|
||||||
|
如果遇到 `InternalAxiosRequestConfig` 类型错误，请确保：
|
||||||
|
|
||||||
|
1. 导入正确的类型：
|
||||||
|
```typescript
|
||||||
|
import { type InternalAxiosRequestConfig } from 'axios'
|
||||||
|
```
|
||||||
|
|
||||||
|
2. 请求拦截器使用正确的类型：
|
||||||
|
```typescript
|
||||||
|
service.interceptors.request.use(
|
||||||
|
(config: InternalAxiosRequestConfig) => {
|
||||||
|
// ...
|
||||||
|
return config
|
||||||
|
}
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
### 2. 跨域问题
|
||||||
|
|
||||||
|
在开发环境中，可通过 `vite.config.ts` 配置代理：
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// vite.config.ts
|
||||||
|
import { defineConfig } from 'vite'
|
||||||
|
|
||||||
|
export default defineConfig({
|
||||||
|
server: {
|
||||||
|
proxy: {
|
||||||
|
'/api': {
|
||||||
|
target: 'http://localhost:3000',
|
||||||
|
changeOrigin: true,
|
||||||
|
rewrite: (path) => path.replace(/^\/api/, '')
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
})
|
||||||
|
```
|
||||||
|
``
|
||||||
|
目前的基础框架默认不包含 PC 端和移动端适配 的配置，需要根据项目需求添加相应方案。以下是几种常见的适配方法及其实现步骤：
|
||||||
|
一、现有框架适配状态
|
||||||
|
你的项目当前是 基础框架，未集成任何适配方案，默认行为是：
|
||||||
|
PC 端：按设计稿尺寸直接渲染，大屏幕可能显得紧凑。
|
||||||
|
移动端：内容可能过大，需要手动缩放或滚动查看
|
||||||
|
``
|
||||||
|
|
||||||
|
## 贡献指南
|
||||||
|
|
||||||
|
1. Fork 仓库
|
||||||
|
2. 创建特性分支：`git checkout -b feature/new-feature`
|
||||||
|
3. 提交代码：`git commit -m 'Add new feature'`
|
||||||
|
4. 推送分支：`git push origin feature/new-feature`
|
||||||
|
5. 提交 Pull Request
|
||||||
|
|
||||||
|
|
||||||
|
## 许可证
|
||||||
|
|
||||||
|
本项目采用 [MIT 许可证](LICENSE)。
|
||||||
0
eslint.config.js
Normal file
0
eslint.config.js
Normal file
13
index.html
Normal file
13
index.html
Normal file
@ -0,0 +1,13 @@
|
|||||||
|
<!doctype html>
|
||||||
|
<html lang="en">
|
||||||
|
<head>
|
||||||
|
<meta charset="UTF-8" />
|
||||||
|
<link rel="icon" type="image/svg+xml" href="/vite.svg" />
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||||
|
<title>Vite + Vue + TS</title>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<div id="app"></div>
|
||||||
|
<script type="module" src="/src/main.ts"></script>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
48
package.json
Normal file
48
package.json
Normal file
@ -0,0 +1,48 @@
|
|||||||
|
{
|
||||||
|
"name": "my-website",
|
||||||
|
"private": true,
|
||||||
|
"version": "0.0.0",
|
||||||
|
"type": "module",
|
||||||
|
"scripts": {
|
||||||
|
"dev": "vite",
|
||||||
|
"build": "vue-tsc -b && vite build",
|
||||||
|
"preview": "vite preview",
|
||||||
|
"lint": "eslint . --ext .vue,.js,.jsx,.ts,.tsx --fix",
|
||||||
|
"lint:check": "eslint . --ext .vue,.js,.jsx,.ts,.tsx",
|
||||||
|
"prepare": "husky install"
|
||||||
|
},
|
||||||
|
"lint-staged": {
|
||||||
|
"*.{vue,js,ts,jsx,tsx}": [
|
||||||
|
"eslint --fix",
|
||||||
|
"prettier --write"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"dependencies": {
|
||||||
|
"@vueuse/core": "^13.3.0",
|
||||||
|
"axios": "^1.9.0",
|
||||||
|
"pinia": "^2.1.7",
|
||||||
|
"vue": "^3.5.13",
|
||||||
|
"vue-router": "^4.5.1"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"@types/axios": "^0.9.36",
|
||||||
|
"@typescript-eslint/eslint-plugin": "^8.33.1",
|
||||||
|
"@typescript-eslint/parser": "^8.33.1",
|
||||||
|
"@vitejs/plugin-vue": "^4.2.3",
|
||||||
|
"@vue/eslint-config-typescript": "^14.5.0",
|
||||||
|
"@vue/tsconfig": "^0.7.0",
|
||||||
|
"autoprefixer": "^10.4.14",
|
||||||
|
"eslint": "^9.28.0",
|
||||||
|
"eslint-plugin-vue": "^10.2.0",
|
||||||
|
"husky": "^8.0.0",
|
||||||
|
"less": "^4.3.0",
|
||||||
|
"less-loader": "^12.3.0",
|
||||||
|
"lint-staged": "^16.1.0",
|
||||||
|
"postcss": "^8.4.24",
|
||||||
|
"prettier": "^3.5.3",
|
||||||
|
"typescript": "~5.8.3",
|
||||||
|
"vite": "^4.4.9",
|
||||||
|
"vite-plugin-image-optimizer": "^1.1.8",
|
||||||
|
"vue-tsc": "^2.2.8"
|
||||||
|
}
|
||||||
|
}
|
||||||
1
public/vite.svg
Normal file
1
public/vite.svg
Normal file
@ -0,0 +1 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>
|
||||||
|
After Width: | Height: | Size: 1.5 KiB |
30
src/App.vue
Normal file
30
src/App.vue
Normal file
@ -0,0 +1,30 @@
|
|||||||
|
<script setup lang="ts">
|
||||||
|
import HelloWorld from './components/HelloWorld.vue'
|
||||||
|
</script>
|
||||||
|
|
||||||
|
<template>
|
||||||
|
<div>
|
||||||
|
<a href="https://vite.dev" target="_blank">
|
||||||
|
<img src="/vite.svg" class="logo" alt="Vite logo" />
|
||||||
|
</a>
|
||||||
|
<a href="https://vuejs.org/" target="_blank">
|
||||||
|
<img src="./assets/vue.svg" class="logo vue" alt="Vue logo" />
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<HelloWorld msg="Vite + Vue" />
|
||||||
|
</template>
|
||||||
|
|
||||||
|
<style scoped>
|
||||||
|
.logo {
|
||||||
|
height: 6em;
|
||||||
|
padding: 1.5em;
|
||||||
|
will-change: filter;
|
||||||
|
transition: filter 300ms;
|
||||||
|
}
|
||||||
|
.logo:hover {
|
||||||
|
filter: drop-shadow(0 0 2em #646cffaa);
|
||||||
|
}
|
||||||
|
.logo.vue:hover {
|
||||||
|
filter: drop-shadow(0 0 2em #42b883aa);
|
||||||
|
}
|
||||||
|
</style>
|
||||||
1
src/assets/vue.svg
Normal file
1
src/assets/vue.svg
Normal file
@ -0,0 +1 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="37.07" height="36" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 198"><path fill="#41B883" d="M204.8 0H256L128 220.8L0 0h97.92L128 51.2L157.44 0h47.36Z"></path><path fill="#41B883" d="m0 0l128 220.8L256 0h-51.2L128 132.48L50.56 0H0Z"></path><path fill="#35495E" d="M50.56 0L128 133.12L204.8 0h-47.36L128 51.2L97.92 0H50.56Z"></path></svg>
|
||||||
|
After Width: | Height: | Size: 496 B |
48
src/components/HelloWorld.vue
Normal file
48
src/components/HelloWorld.vue
Normal file
@ -0,0 +1,48 @@
|
|||||||
|
<template>
|
||||||
|
<div>
|
||||||
|
<button @click="fetchData">获取数据</button>
|
||||||
|
<div v-if="loading">加载中...</div>
|
||||||
|
<div v-else>{{ data }}</div>
|
||||||
|
</div>
|
||||||
|
</template>
|
||||||
|
|
||||||
|
<script setup lang="ts">
|
||||||
|
import { ref } from 'vue'
|
||||||
|
import request from '@/utils/request' // 根据项目路径调整
|
||||||
|
|
||||||
|
const data = ref(null)
|
||||||
|
const loading = ref(false)
|
||||||
|
|
||||||
|
// GET 请求示例
|
||||||
|
const fetchData = async () => {
|
||||||
|
loading.value = true
|
||||||
|
try {
|
||||||
|
// 1. 基本 GET 请求
|
||||||
|
const res = await request.get('/api/users')
|
||||||
|
data.value = res
|
||||||
|
|
||||||
|
// 2. 带参数的 GET 请求
|
||||||
|
const params = { page: 1, limit: 10 }
|
||||||
|
const paginatedData = await request.get('/api/users', params)
|
||||||
|
|
||||||
|
// 3. 自定义配置的请求
|
||||||
|
const config = { headers: { 'X-Custom-Header': 'token' } }
|
||||||
|
const specialData = await request.get('/api/special', null, config)
|
||||||
|
} catch (error) {
|
||||||
|
console.error('请求失败:', error)
|
||||||
|
} finally {
|
||||||
|
loading.value = false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// POST 请求示例
|
||||||
|
const createItem = async () => {
|
||||||
|
try {
|
||||||
|
const payload = { name: '新项目', status: 'active' }
|
||||||
|
const res = await request.post('/api/items', payload)
|
||||||
|
console.log('创建成功:', res)
|
||||||
|
} catch (error) {
|
||||||
|
console.error('创建失败:', error)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
</script>
|
||||||
6
src/components/Test.vue
Normal file
6
src/components/Test.vue
Normal file
@ -0,0 +1,6 @@
|
|||||||
|
<template>
|
||||||
|
<div>{{ message }}</div>
|
||||||
|
</template>
|
||||||
|
<script setup lang="ts">
|
||||||
|
const message = 'hello' // 故意使用双引号
|
||||||
|
</script>
|
||||||
5
src/main.ts
Normal file
5
src/main.ts
Normal file
@ -0,0 +1,5 @@
|
|||||||
|
import { createApp } from 'vue'
|
||||||
|
import './style.css'
|
||||||
|
import App from './App.vue'
|
||||||
|
|
||||||
|
createApp(App).mount('#app')
|
||||||
79
src/style.css
Normal file
79
src/style.css
Normal file
@ -0,0 +1,79 @@
|
|||||||
|
:root {
|
||||||
|
font-family: system-ui, Avenir, Helvetica, Arial, sans-serif;
|
||||||
|
line-height: 1.5;
|
||||||
|
font-weight: 400;
|
||||||
|
|
||||||
|
color-scheme: light dark;
|
||||||
|
color: rgba(255, 255, 255, 0.87);
|
||||||
|
background-color: #242424;
|
||||||
|
|
||||||
|
font-synthesis: none;
|
||||||
|
text-rendering: optimizeLegibility;
|
||||||
|
-webkit-font-smoothing: antialiased;
|
||||||
|
-moz-osx-font-smoothing: grayscale;
|
||||||
|
}
|
||||||
|
|
||||||
|
a {
|
||||||
|
font-weight: 500;
|
||||||
|
color: #646cff;
|
||||||
|
text-decoration: inherit;
|
||||||
|
}
|
||||||
|
a:hover {
|
||||||
|
color: #535bf2;
|
||||||
|
}
|
||||||
|
|
||||||
|
body {
|
||||||
|
margin: 0;
|
||||||
|
display: flex;
|
||||||
|
place-items: center;
|
||||||
|
min-width: 320px;
|
||||||
|
min-height: 100vh;
|
||||||
|
}
|
||||||
|
|
||||||
|
h1 {
|
||||||
|
font-size: 3.2em;
|
||||||
|
line-height: 1.1;
|
||||||
|
}
|
||||||
|
|
||||||
|
button {
|
||||||
|
border-radius: 8px;
|
||||||
|
border: 1px solid transparent;
|
||||||
|
padding: 0.6em 1.2em;
|
||||||
|
font-size: 1em;
|
||||||
|
font-weight: 500;
|
||||||
|
font-family: inherit;
|
||||||
|
background-color: #1a1a1a;
|
||||||
|
cursor: pointer;
|
||||||
|
transition: border-color 0.25s;
|
||||||
|
}
|
||||||
|
button:hover {
|
||||||
|
border-color: #646cff;
|
||||||
|
}
|
||||||
|
button:focus,
|
||||||
|
button:focus-visible {
|
||||||
|
outline: 4px auto -webkit-focus-ring-color;
|
||||||
|
}
|
||||||
|
|
||||||
|
.card {
|
||||||
|
padding: 2em;
|
||||||
|
}
|
||||||
|
|
||||||
|
#app {
|
||||||
|
max-width: 1280px;
|
||||||
|
margin: 0 auto;
|
||||||
|
padding: 2rem;
|
||||||
|
text-align: center;
|
||||||
|
}
|
||||||
|
|
||||||
|
@media (prefers-color-scheme: light) {
|
||||||
|
:root {
|
||||||
|
color: #213547;
|
||||||
|
background-color: #ffffff;
|
||||||
|
}
|
||||||
|
a:hover {
|
||||||
|
color: #747bff;
|
||||||
|
}
|
||||||
|
button {
|
||||||
|
background-color: #f9f9f9;
|
||||||
|
}
|
||||||
|
}
|
||||||
138
src/utils/request.ts
Normal file
138
src/utils/request.ts
Normal file
@ -0,0 +1,138 @@
|
|||||||
|
// src/utils/request.ts
|
||||||
|
import axios, {
|
||||||
|
type AxiosInstance,
|
||||||
|
type AxiosRequestConfig,
|
||||||
|
type AxiosResponse,
|
||||||
|
type AxiosError,
|
||||||
|
type InternalAxiosRequestConfig
|
||||||
|
} from 'axios'
|
||||||
|
|
||||||
|
// 定义 API 响应结构
|
||||||
|
interface ApiResponse<T = any> {
|
||||||
|
code: number
|
||||||
|
message: string
|
||||||
|
data: T
|
||||||
|
}
|
||||||
|
|
||||||
|
// 创建 axios 实例
|
||||||
|
const service: AxiosInstance = axios.create({
|
||||||
|
baseURL: import.meta.env.VITE_API_BASE_URL || '',
|
||||||
|
timeout: 10000,
|
||||||
|
headers: {
|
||||||
|
'Content-Type': 'application/json;charset=utf-8'
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
// 请求拦截器
|
||||||
|
service.interceptors.request.use(
|
||||||
|
(config: InternalAxiosRequestConfig) => {
|
||||||
|
const token = localStorage.getItem('token')
|
||||||
|
if (token) {
|
||||||
|
config.headers.Authorization = `Bearer ${token}`
|
||||||
|
}
|
||||||
|
return config
|
||||||
|
},
|
||||||
|
(error: AxiosError) => {
|
||||||
|
console.error('请求错误:', error)
|
||||||
|
showError('请求发送失败')
|
||||||
|
return Promise.reject(error)
|
||||||
|
}
|
||||||
|
)
|
||||||
|
|
||||||
|
// 响应拦截器
|
||||||
|
service.interceptors.response.use(
|
||||||
|
(response: AxiosResponse<ApiResponse>) => {
|
||||||
|
const res = response.data
|
||||||
|
if (res.code !== 200) {
|
||||||
|
showError(res.message || '请求失败')
|
||||||
|
return Promise.reject(new Error(res.message || '请求失败'))
|
||||||
|
}
|
||||||
|
return res.data
|
||||||
|
},
|
||||||
|
(error: AxiosError<ApiResponse>) => {
|
||||||
|
console.error('响应错误:', error)
|
||||||
|
const status = error.response?.status
|
||||||
|
const message = error.response?.data?.message || '网络错误，请稍后重试'
|
||||||
|
|
||||||
|
switch (status) {
|
||||||
|
case 401:
|
||||||
|
showError('未登录或登录已过期')
|
||||||
|
window.location.href = '/login'
|
||||||
|
break
|
||||||
|
case 403:
|
||||||
|
showError('权限不足，无法访问')
|
||||||
|
break
|
||||||
|
case 404:
|
||||||
|
showError('请求资源不存在')
|
||||||
|
break
|
||||||
|
case 500:
|
||||||
|
showError('服务器内部错误')
|
||||||
|
break
|
||||||
|
default:
|
||||||
|
showError(message)
|
||||||
|
}
|
||||||
|
|
||||||
|
return Promise.reject(error)
|
||||||
|
}
|
||||||
|
)
|
||||||
|
|
||||||
|
// 原生错误提示函数
|
||||||
|
function showError(message: string) {
|
||||||
|
alert(message)
|
||||||
|
|
||||||
|
// 或使用 DOM 创建自定义提示（可选）
|
||||||
|
// const errorDiv = document.createElement('div')
|
||||||
|
// errorDiv.textContent = message
|
||||||
|
// errorDiv.style.cssText = 'position:fixed;top:20px;right:20px;background-color:#f56c6c;color:white;padding:10px;border-radius:4px;z-index:1000;'
|
||||||
|
// document.body.appendChild(errorDiv)
|
||||||
|
// setTimeout(() => {
|
||||||
|
// document.body.removeChild(errorDiv)
|
||||||
|
// }, 3000)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 定义请求方法
|
||||||
|
const request = {
|
||||||
|
get<T = any>(url: string, params?: any, config?: AxiosRequestConfig): Promise<T> {
|
||||||
|
return service.get(url, { params, ...config })
|
||||||
|
},
|
||||||
|
|
||||||
|
post<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T> {
|
||||||
|
return service.post(url, data, config)
|
||||||
|
},
|
||||||
|
|
||||||
|
put<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T> {
|
||||||
|
return service.put(url, data, config)
|
||||||
|
},
|
||||||
|
|
||||||
|
delete<T = any>(url: string, params?: any, config?: AxiosRequestConfig): Promise<T> {
|
||||||
|
return service.delete(url, { params, ...config })
|
||||||
|
},
|
||||||
|
|
||||||
|
upload<T = any>(url: string, file: File, config?: AxiosRequestConfig): Promise<T> {
|
||||||
|
const formData = new FormData()
|
||||||
|
formData.append('file', file)
|
||||||
|
return service.post(url, formData, {
|
||||||
|
headers: { 'Content-Type': 'multipart/form-data' },
|
||||||
|
...config
|
||||||
|
})
|
||||||
|
},
|
||||||
|
|
||||||
|
download(url: string, params?: any, filename?: string): Promise<void> {
|
||||||
|
return service
|
||||||
|
.get(url, {
|
||||||
|
params,
|
||||||
|
responseType: 'blob'
|
||||||
|
})
|
||||||
|
.then(response => {
|
||||||
|
const url = window.URL.createObjectURL(new Blob([response.data]))
|
||||||
|
const link = document.createElement('a')
|
||||||
|
link.href = url
|
||||||
|
link.setAttribute('download', filename || '文件下载')
|
||||||
|
document.body.appendChild(link)
|
||||||
|
link.click()
|
||||||
|
document.body.removeChild(link)
|
||||||
|
})
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export default request
|
||||||
1
src/vite-env.d.ts
vendored
Normal file
1
src/vite-env.d.ts
vendored
Normal file
@ -0,0 +1 @@
|
|||||||
|
/// <reference types="vite/client" />
|
||||||
19
tsconfig.app.json
Normal file
19
tsconfig.app.json
Normal file
@ -0,0 +1,19 @@
|
|||||||
|
{
|
||||||
|
"extends": "@vue/tsconfig/tsconfig.dom.json",
|
||||||
|
"compilerOptions": {
|
||||||
|
"baseUrl": ".",
|
||||||
|
"paths": {
|
||||||
|
"@/*": ["src/*"] // 添加路径别名
|
||||||
|
},
|
||||||
|
"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
|
||||||
|
|
||||||
|
/* Linting */
|
||||||
|
"strict": true,
|
||||||
|
"noUnusedLocals": true,
|
||||||
|
"noUnusedParameters": true,
|
||||||
|
"erasableSyntaxOnly": true,
|
||||||
|
"noFallthroughCasesInSwitch": true,
|
||||||
|
"noUncheckedSideEffectImports": true
|
||||||
|
},
|
||||||
|
"include": ["src/**/*.ts", "src/**/*.tsx", "src/**/*.vue"]
|
||||||
|
}
|
||||||
7
tsconfig.json
Normal file
7
tsconfig.json
Normal file
@ -0,0 +1,7 @@
|
|||||||
|
{
|
||||||
|
"files": [],
|
||||||
|
"references": [
|
||||||
|
{ "path": "./tsconfig.app.json" },
|
||||||
|
{ "path": "./tsconfig.node.json" }
|
||||||
|
]
|
||||||
|
}
|
||||||
25
tsconfig.node.json
Normal file
25
tsconfig.node.json
Normal file
@ -0,0 +1,25 @@
|
|||||||
|
{
|
||||||
|
"compilerOptions": {
|
||||||
|
"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
|
||||||
|
"target": "ES2022",
|
||||||
|
"lib": ["ES2023"],
|
||||||
|
"module": "ESNext",
|
||||||
|
"skipLibCheck": true,
|
||||||
|
|
||||||
|
/* Bundler mode */
|
||||||
|
"moduleResolution": "bundler",
|
||||||
|
"allowImportingTsExtensions": true,
|
||||||
|
"verbatimModuleSyntax": true,
|
||||||
|
"moduleDetection": "force",
|
||||||
|
"noEmit": true,
|
||||||
|
|
||||||
|
/* Linting */
|
||||||
|
"strict": true,
|
||||||
|
"noUnusedLocals": true,
|
||||||
|
"noUnusedParameters": true,
|
||||||
|
"erasableSyntaxOnly": true,
|
||||||
|
"noFallthroughCasesInSwitch": true,
|
||||||
|
"noUncheckedSideEffectImports": true
|
||||||
|
},
|
||||||
|
"include": ["vite.config.ts"]
|
||||||
|
}
|
||||||
12
vite.config.ts
Normal file
12
vite.config.ts
Normal file
@ -0,0 +1,12 @@
|
|||||||
|
import { defineConfig } from 'vite'
|
||||||
|
import vue from '@vitejs/plugin-vue'
|
||||||
|
import path from 'path' // 引入 path 模块
|
||||||
|
|
||||||
|
export default defineConfig({
|
||||||
|
plugins: [vue()],
|
||||||
|
resolve: {
|
||||||
|
alias: {
|
||||||
|
'@': path.resolve(__dirname, 'src') // 添加路径别名
|
||||||
|
}
|
||||||
|
}
|
||||||
|
})
|
||||||
Loading…
Reference in New Issue
Block a user