企业官网建设流程全解析

市场营销案例100例及答案,seo专员是什么职业,wordpress消除,个人网站制作代码点击上方 程序员成长指北#xff0c;关注公众号 回复1#xff0c;加入高级Node交流群十条经过实战检验的 TypeScript monorepo 约定 —— 覆盖命名、TS 配置、project references、构建、发布、测试与边界控制 —— 让代码库能够在时间中稳定扩展。Monorepo 在最初总是让人感…点击上方 程序员成长指北关注公众号 回复1加入高级Node交流群十条经过实战检验的 TypeScript monorepo 约定 —— 覆盖命名、TS 配置、project references、构建、发布、测试与边界控制 —— 让代码库能够在时间中稳定扩展。Monorepo 在最初总是让人感觉非常顺滑 —— 但六个月后就会变得一团糟。秘诀不在于炫技的工具链而在于一小套朴素但持久的约定。下面这十条约定能够帮助团队持续交付不再出现“谁又把什么弄坏了”这种戏码。说实话未来的你一定会感谢现在的你。1按业务域命名而不是按技术层命名使用业务语言auth、billing、search而不是技术层utils、helpers。这会促使更清晰的边界划分也更容易确定归属。apps/ web/ worker/packages/ auth/ billing/ search/ ui/为什么能长期有效业务域可以经得住重构而技术层不会。2统一使用 workspaces workspace: 协议选择一个工具我偏好 pnpm因为速度快且更严格并用workspace:*来明确本地依赖同时避免版本耦合。// package.json (root){ name: acme/monorepo, private: true, packageManager: pnpm9.0.0, workspaces: [apps/*, packages/*], scripts: { build: pnpm -r build, test: pnpm -r test }}// apps/web/package.json{ name: acme/web, dependencies: { acme/auth: workspace:*, acme/ui: workspace:* }}为什么能长期有效不会意外发布半成品版本也不会造成同级包之间的 semver 漂移。3使用一个严格的 tsconfig.base.json —— 然后所有子包继承它把严格规则放在最顶层只有在确有需求时才下放例外。// tsconfig.base.json at the repo root{ compilerOptions: { target: ES2022, module: ESNext, moduleResolution: Bundler, lib: [ES2022, DOM], strict: true, noUncheckedIndexedAccess: true, exactOptionalPropertyTypes: true, skipLibCheck: true, declaration: true, declarationMap: true, verbatimModuleSyntax: true, isolatedModules: true }}子包配置{ extends: ../../tsconfig.base.json, compilerOptions: { outDir: dist, rootDir: src, composite: true }, include: [src]}为什么能长期有效统一的基础规则能够避免风格漂移和微妙的类型退化。4使用 TypeScript Project References build mode这决定了你的 monorepo 究竟是“任何改变都会触发全量构建”还是“只构建变动部分”。// packages/ui/tsconfig.json{ extends: ../../tsconfig.base.json, compilerOptions: { composite: true, outDir: dist, rootDir: src }, references: [{ path: ../auth }]}根目录脚本tsc -b packages/* # 以依赖图增量构建全部包tsc -b -w # watch 模式下使用 references为什么能长期有效 随着依赖图规模扩大构建依然保持增量而不是变慢。5统一库构建工具库用 tsup开发用 tsx不要同时操控多个 bundler。保持工具链简单直观。// packages/auth/package.json{ name: acme/auth, type: module, main: ./dist/index.cjs, module: ./dist/index.mjs, types: ./dist/index.d.ts, scripts: { dev: tsx watch src/index.ts, build: tsup src/index.ts --dts --format esm,cjs --clean }}为什么能长期有效团队可能每年都会想换 bundler但你不需要 —— tsup 和 tsx 足够快且可预期。6使用干净的 exports不要允许 deep imports只暴露你希望暴露的内容。应用层不应该通过packages/ui/src/button这种路径导入内部实现。// packages/ui/package.json{ name: acme/ui, type: module, sideEffects: false, exports: { .: { types: ./dist/index.d.ts, import: ./dist/index.mjs, require: ./dist/index.cjs } }, files: [dist]}为什么能长期有效包内部的重命名不会影响整个 monorepo。7使用 Changesets 发布两条命令自动化 release人类可读的变更说明现在写好自动化 semver 稍后执行。// .changeset/config.json{ changelog: changesets/cli/changelog, commit: false, linked: [], access: public, baseBranch: main}// root package.json{ scripts: { changeset: changeset, version-packages: changeset version, release: pnpm -r build changeset publish }}为什么能长期有效改动意图清晰标记一致不再有 “到底发布了啥” 的疑问。8用 ESLint 强化边界而不是靠团队默契明确规定“谁可以 import 谁”。这样能减少争议。// .eslintrc.cjs (root)module.exports { root: true, parser: typescript-eslint/parser, plugins: [typescript-eslint, import], extends: [eslint:recommended, plugin:typescript-eslint/recommended], rules: { import/no-restricted-paths: [error, { zones: [ { target: ./packages/auth, from: ./packages/ui }, // ui 不能 import auth { target: ./packages/billing, from: ./packages/auth} // auth 不能 import billing ] }], import/no-cycle: error }}为什么能长期有效边界设定存活在机器人和工具里而不是口口相传的默契。9一个测试运行器多项目共用Vitest workspace保持测试快速且一致。测试文件与代码邻近从根目录一次性运行所有测试。// vitest.workspace.ts at the rootimport { defineWorkspace } from vitest/config export default defineWorkspace([ { test: { include: [packages/auth/src/**/*.test.ts] } }, { test: { include: [packages/ui/src/**/*.test.tsx] } }, { test: { include: [apps/web/src/**/*.test.tsx] } },])为什么能长期有效共用 reporters、快照与覆盖率不需要为每个包定制配置。10集中管理环境变量类型在 acme/env 中用 Zod 校验不要把process.env.FOO散落在代码各处。验证一次到处复用。// packages/env/src/index.tsimport { z } from zod const schema z.object({ NODE_ENV: z.enum([development, test, production]), DATABASE_URL: z.string().url(), PORT: z.coerce.number().int().default(3000)}) export const env schema.parse(process.env)export type Env z.infertypeof schema在任意应用中使用import { env } from acme/envapp.listen(env.PORT)为什么能长期有效 环境配置不正确会尽早失败 —— 还带着类型提示而不是凌晨两点崩在生产上。一些微小但长期有效的习惯库中优先使用 named exports更易重构。每个包保留 README.md记录其作用与示例 import。在 CODEOWNERS 中标注模块负责人方便分流评审。添加 prepack 脚本确保发布前构建正确。结语Monorepo 并不会因为某个“大问题”而失败而是因为无数个小问题不断累积。以上十条约定能减少团队、包和需求增加所带来的摩擦。如果你也有经历战火、价值连城的经验技巧欢迎分享 —— 我一定会借鉴当然也会注明出处。地址https://medium.com/kaushalsinh73/10-typescript-monorepo-conventions-that-age-well-c1a6841226f5原文作者 NeurobyteNode 社群我组建了一个氛围特别好的 Node.js 社群里面有很多 Node.js小伙伴如果你对Node.js学习感兴趣的话后续有计划也可以我们可以一起进行Node.js相关的交流、学习、共建。下方加 考拉 好友回复「Node」即可。 “分享、点赞、在看” 支持一波