v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T09:10:00.000Z▲ 0 upvotes

FSD trong Next.js không nhập theo chu kỳ: lớp, API công khai và xác minh tự động

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

Chu kỳ đến từ đâu?

Đại lý bổ sung thêm tính năng “thêm vào mục yêu thích”. Nó cần loại Product, nó nhập nó từ entities/product. Sau đó, bạn cần nhúng nút yêu thích vào thẻ sản phẩm và tác nhân nhập features/favorites trực tiếp vào entities/product/ui/ProductCard.tsx. Kết quả là một vòng tuần hoàn: bản chất tùy thuộc vào đặc tính, đặc tính phụ thuộc vào bản chất. Trong thời gian chạy, điều này biểu hiện dưới dạng undefined cho giá trị được nhập trong quá trình khởi tạo mô-đun và trong tập hợp dưới dạng thứ tự các khối không thể đoán trước.

FSD giải quyết vấn đề này bằng một quy tắc: một mô-đun chỉ có thể nhập từ các lớp bên dưới chính nó và các lát của cùng một lớp không biết về nhau.

Các lớp và hướng phụ thuộc

app        → инициализация, провайдеры, глобальные стили
pages      → композиция страниц
widgets    → крупные самостоятельные блоки (шапка, лента, карточка с действиями)
features   → пользовательские действия (добавить в избранное, авторизоваться)
entities   → бизнес-сущности (product, user, order)
shared     → UI-кит, утилиты, api-клиент, конфиг; без бизнес-логики

Chỉ được phép nhập từ trên xuống dưới: widgets có thể sử dụng features, entities, shared; entities - chỉ shared. shared không nhập bất cứ thứ gì từ các lớp trên.

Ví dụ về mục yêu thích được giải quyết bằng cách kết hợp ở cấp độ cao hơn: ProductCard từ entities chiếm vị trí actions và widgets/product-list chuyển đến đó một nút từ features/favorites.

// entities/product/ui/ProductCard.tsx
export function ProductCard({ product, actions }: { product: Product; actions?: React.ReactNode }) {
  return (
    <div>
      <h3>{product.title}</h3>
      <span>{product.price}</span>
      {actions}
    </div>
  );
}

// widgets/product-list/ui/ProductList.tsx
import { ProductCard } from "@/entities/product";
import { ToggleFavorite } from "@/features/favorites";

export function ProductList({ items }: { items: Product[] }) {
  return items.map(p => <ProductCard key={p.id} product={p} actions={<ToggleFavorite productId={p.id} />} />);
}

API lát công khai

Mỗi lát chỉ xuất những gì được khai báo trong index.ts của nó:

// entities/product/index.ts
export { ProductCard } from "./ui/ProductCard";
export type { Product } from "./model/types";
export { getProduct } from "./api/getProduct";

Cấm nhập @/entities/product/ui/ProductCard bỏ qua index.ts. Điều này cho phép bạn thay đổi cấu trúc bên trong của slice mà không ảnh hưởng đến người tiêu dùng.

Khi các thực thể cần biết về nhau

Order chứa Product và loại đơn đặt hàng đề cập đến loại sản phẩm. Đối với những trường hợp như vậy, FSD có ký hiệu @x - một API công khai riêng cho một hàng xóm cụ thể:

// entities/product/@x/order.ts
export type { Product } from "../model/types";

// entities/order/model/types.ts
import type { Product } from "@/entities/product/@x/order";
export type Order = { id: string; items: { product: Product; qty: number }[] };

Mối quan hệ này có thể nhìn thấy và giới hạn ở các loại. Nếu logic bắt đầu chuyển qua @x thì đây là tín hiệu cho thấy các thực thể nên được kết hợp hoặc đưa chung vào shared.

Bộ định tuyến ứng dụng Next.js và FSD

Các thư mục app và pages trong FSD có cùng tên với định tuyến Next.js. Tùy chọn được đề xuất: Định tuyến Next.js vẫn ở thư mục gốc app/, các lớp FSD nằm trong src/ và chỉ định tuyến các tệp tái xuất các trang:

app/
  products/[id]/page.tsx   → export { ProductPage as default } from "@/pages/product";
src/
  app/        # провайдеры, стили
  pages/
  widgets/
  features/
  entities/
  shared/
pages/README.md            # пустая корневая папка, чтобы Next.js не принял src/pages за Pages Router

Kiểm tra tự động

Đại lý sẽ vi phạm các quy tắc mà không kiểm tra ngay cơ hội đầu tiên. Ba nhạc cụ bổ sung cho nhau.

Steiger - kẻ nói dối chính thức của FSD, kiểm tra cấu trúc, API công khai và hướng nhập:

npx steiger ./src

ESLint với import/no-restricted-paths ngăn việc nhập các lớp trực tiếp trong trình chỉnh sửa:

// eslint.config.mjs (фрагмент)
import importPlugin from "eslint-plugin-import";

export default [
  {
    plugins: { import: importPlugin },
    rules: {
      "import/no-cycle": ["error", { maxDepth: 10 }],
      "import/no-restricted-paths": ["error", {
        zones: [
          { target: "./src/shared", from: ["./src/entities", "./src/features", "./src/widgets", "./src/pages", "./src/app"] },
          { target: "./src/entities", from: ["./src/features", "./src/widgets", "./src/pages", "./src/app"] },
          { target: "./src/features", from: ["./src/widgets", "./src/pages", "./src/app"] },
          { target: "./src/widgets", from: ["./src/pages", "./src/app"] },
        ],
      }],
    },
  },
];

Việc cấm nhập chéo trong một lớp (features/a → features/b) được kiểm tra bởi Steiger; Các vùng ESLint không thể hiện điều này nếu không liệt kê từng lát cắt.

madge tìm các vòng lặp hiện có trong dự án:

npx madge --circular --extensions ts,tsx --ts-config tsconfig.json src

import/no-cycle trên một dự án lớn làm chậm đáng kể quá trình linting; nó chỉ có thể chạy trong CI, để lại các vùng trong trình chỉnh sửa.

Quy tắc đại lý

- Слои: app > pages > widgets > features > entities > shared. Импорт только вниз.
- Слайсы одного слоя не импортируют друг друга. Связь — через композицию на слое выше.
- Импорт из слайса только через его index.ts.
- Типы соседней сущности — только через entities/<name>/@x/<consumer>.ts.
- После изменений запусти npx steiger ./src и исправь все ошибки.

Khi FSD không cần thiết

Đối với một trang đích, bảng quản trị cho hàng chục màn hình hoặc một nguyên mẫu, FSD bổ sung thêm nhiều thư mục hơn mức hữu ích. Chỉ cần tách components, lib và app và bao gồm import/no-cycle là đủ. Phương pháp này có hiệu quả khi nhiều người hoặc đại lý làm việc trên mã cùng lúc và có hơn hai chục tính năng.

Обсуждение (0)

Ещё на vbcd4u.com