5

// .eslintrc.js
module.exports = {
  extends: [
    '@nuxt/eslint-config',
    'plugin:prettier/recommended',
    'plugin:vue/vue3-recommended',
    'plugin:@typescript-eslint/recommended'
  ],
  parserOptions: {
    ecmaVersion: 2020,
    parser: '@typescript-eslint/parser'
  },
  rules: {
    // 基础规则
    'no-console': process.env.NODE_ENV === 'production' ? 'warn' : 'off',
    'no-debugger': process.env.NODE_ENV === 'production' ? 'warn' : 'off',
    
    // Vue 规则
    'vue/multi-word-component-names': 'warn',
    'vue/attribute-hyphenation': 'on',
    'vue/require-default-prop': 'off',
    
    // TypeScript 规则
    '@typescript-eslint/explicit-module-boundary-types': 'warn',
    '@typescript-eslint/no-explicit-any': 'warn'
  }
}

4.4.1.2 Prettier 配置

创建或完善 .prettierrc 文件：

{
  "semi": false,
  "singleQuote": true,
  "trailingComma": "es5",
  "printWidth": 80,
  "tabWidth": 2,
  "arrowParens": "avoid",
  "vueIndentScriptAndStyle": true
}

4.4.1.3 TypeScript 配置

在 tsconfig.json 中添加严格的类型检查选项：

{
  "compilerOptions": {
    "strict": true,
    "noImplicitAny": true,
    "strictNullChecks": true,
    "strictFunctionTypes": true,
    "strictBindCallApply": true,
    "strictPropertyInitialization": true,
    "noImplicitThis": true,
    "alwaysStrict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  }
}

4.4.1.4 package.json 中的脚本配置

{
  "scripts": {
    "lint": "eslint . --ext .vue,.js,.jsx,.cjs,.mjs,.ts,.tsx,.cts,.mts --fix --ignore-path .gitignore",
    "format": "prettier --write .",
    "type-check": "vue-tsc --noEmit -p tsconfig.json --composite false"
  }
}

4.4.2 后端项目配置

4.4.2.1 pyproject.toml 配置

[tool.black]
line-length = 88
target-version = ['py39']
include = '\\.pyi?$'
exclude = '''
/(\\.
  |venv
  |__pycache__
  |build
  |dist
)/
'''

[tool.isort]
profile = "black"
line_length = 88
known_first_party = ["app"]
known_third_party = ["fastapi", "uvicorn", "sqlalchemy", "pydantic"]

[tool.flake8]
max-line-length = 88
extend-ignore = ["E203", "W503"]
select = ["E9", "F63", "F7", "F82"]

4.4.2.2 mypy 配置（可选，用于类型检查）

创建 mypy.ini 文件：

[mypy]
python_version = 3.9
warn_return_any = True
warn_unused_configs = True
no_implicit_optional = True
disallow_untyped_defs = False
disallow_incomplete_defs = False
check_untyped_defs = False

[mypy-fastapi.*]
follow_imports = skip

[mypy-pydantic.*]
follow_imports = skip

4.4.2.3 任务脚本配置

使用 taskipy 或创建 Makefile 来管理开发任务：

# 在 pyproject.toml 中添加
[tool.taskipy.tasks]
dev = "uvicorn app.main:app --reload --host 0.0.0.0 --port 8000"
test = "pytest"
format = "black app tests && isort app tests"
lint = "flake8 app tests"
check-types = "mypy app"
check-all = "task format && task lint && task check-types && task test"

4.4.3 工具使用指南

通过以上配置，你可以在开发过程中使用以下命令来保持代码质量：

前端项目：

pnpm run lint - 检查并修复代码风格问题
pnpm run format - 格式化所有代码
pnpm run type-check - 运行 TypeScript 类型检查

后端项目：

task format - 使用 Black 和 isort 格式化代码
task lint - 使用 Flake8 检查代码质量
task check-types - 使用 mypy 检查类型
task check-all - 运行所有检查和测试

这些工具和配置将帮助你在项目开发过程中保持一致的代码风格，减少常见错误，并提高代码的可读性和可维护性。