writing-typescript

用途：在编写 TypeScript 代码、Node.js 服务、React 应用或讨论 TS 模式时提供惯用写法参考。核心原则：启用全部严格检查；在边界处转换不可信数据而非校验；优先小函数组合而非继承；显式优于隐式，不用 any，优先 unknown。工具链：bun 作为运行时与包管理器，vite 用于前端打包，vitest 测试，eslint 检查，prettier 格式化。常见模式包括类型守卫、可辨识联合（如 Result<T,E>）、工具类型 Partial/Pick/Omit/Readonly 等。tsconfig 推荐 target ES2022、module ESNext、moduleResolution bundler、strict true、noUncheckedIndexedAccess、exactOptionalPropertyTypes、noImplicitReturns、isolatedModules。参考文档包含 PATTERNS.md、REACT.md、TESTING.md。常用命令：bun install、bun run build、bun test、bun run lint、bun run format。注意事项：import type 配合 verbatimModuleSyntax 与具名导出时，对值做仅类型导入会报错，可用 import { type Foo } from "mod" 修复；对象上的 as const 是只读且字面量收窄，不同于 as Foo 的类型断言和 satisfies Foo 的不拓宽校验；satisfies 校验而不拓宽，as 会拓宽；Array<T>.includes(x) 要求 x 为 T 类型，联合类型收窄不适用，标准解法是类型谓词辅助函数；strictNullChecks 关闭会使所有 T 含义变为 T | null | undefined；tsconfig 的 extends 不会递归合并 compilerOptions.paths，子级 paths 会替换父级而非合并。平台、收费、价格等信息暂未提供。