教Claude你的编码风格:个人风格配置文件写法(super useful)

作者:互联网

2026-03-05

多模态⽣成脚本

在2026年,Claude Code / claude.dev / Claude.ai 已经非常擅长“读懂”项目风格,但如果你希望它长期、稳定、一致地按照你的个人编码习惯写代码,最有效的方式仍然是:

在项目根目录放一个 CLAUDE.md 或 .claude-style.md 文件,Claude 会自动读取它作为“系统提示”的一部分(相当于给它戴上了你的风格眼镜)。

为什么这个方法最强?
 • 每次对话/每次生成代码都会自动带上
 • 不需要每次Prompt都重复写一堆规则
 • Claude 上下文窗口足够大,放 800–1500 字都没问题
 • 团队协作时也能共享(放在 repo 里所有人受益)

1772676159333618.png

推荐的文件名 & 放置位置

  • 首选:项目根目录下 CLAUDE.md(Claude Code 会自动优先读取)

  • 次选: .claude-style.mdclaude-guidelines.md

  • 多语言项目可放 CLAUDE.zh.md / CLAUDE.en.md

2026年最推荐的个人风格配置文件模板(直接复制修改)

# CLAUDE.md - 我的编码风格配置文件最后更新: 2026-03-05## 全局风格要求(所有语言/项目通用)- 永远使用 TypeScript(严格模式)或 Python 3.11+ 类型提示- 命名规范:camelCase for variables/functions, PascalCase for classes/types, UPPER_SNAKE_CASE for constants- 缩进:2空格(前端) / 4空格(Python/后端)- 最大行宽:100字符(超过自动换行)- 注释风格:JSDoc / Google-style docstring,函数/类必须有,复杂逻辑必须有行内注释- 错误处理:永远显式处理错误,不要用 .catch(e => {}) 吞异常- 日志:使用结构化日志(console.log + JSON),生产环境用 winston/pino- 性能:优先可读性,其次性能;必要时加 memoization/useMemo/useCallback- 代码异味零容忍:避免 magic number、deep nesting、神对象、重复代码## 前端(React / Next.js)专属规则- React 19 + Next.js 16+(App Router)- 函数组件 + hooks,禁止 class component- 组件文件结构:index.tsx + styles.module.css / tailwind- 优先使用 shadcn/ui + lucide-react- Server Actions 优先于传统 API routes- 数据获取:优先 useSWR / TanStack Query,其次 fetch + suspense- 状态管理:小组件用 useState,中等用 Zustand,大型用 Redux Toolkit + RTK Query- 类型安全:strict mode,禁止 any,复杂类型用 z.infer## 后端(Node.js / Python)专属规则- Node.js:Fastify / NestJS > Express,优先 async/await- Python:FastAPI > Flask,pydantic v2 + type hints- 数据库:Prisma(TS) / SQLAlchemy 2.0(Python),禁止 raw SQL 除非性能极致要求- 认证:JWT + refresh token,优先 Lucia / NextAuth v5- 错误处理:统一 Error 类 + status code mapping- 测试:Vitest / pytest,目标 85%+ 覆盖率## 禁止项(Claude 永远不要生成这些)- var 声明- console.log 直接输出敏感信息- any 类型(除非第三方库确实无法推导)- 嵌套超过 4 层 if/else(改用 early return / guard clause)- 魔法数字/字符串(全部抽成常量)- 未处理的 Promise rejection## 偏好示例(Claude 应模仿这种写法)函数示例(TS):```ts/** * Calculates the total price with discount applied * @param items - Array of cart items * @param discountCode - Optional discount code * @returns Total price in cents * @throws {InvalidDiscountError} If discount code is invalid */export function calculateTotal(items: CartItem[], discountCode?: string): number {  if (!items.length) return 0;  const subtotal = items.reduce((sum, item) => sum + item.price * item.quantity, 0);  if (!discountCode) return subtotal;  const discount = getDiscountValue(discountCode);  if (discount === null) {    throw new InvalidDiscountError(discountCode);  }  return Math.max(0, subtotal - discount);}```请严格遵守以上全部规则,除非用户明确要求否则不得违背。每次生成代码前,自动在思考中检查是否符合本文件要求。

如何让Claude更严格遵守?

在每次重要Prompt开头加一句: ``` 严格遵守项目根目录 CLAUDE.md 中的所有编码风格要求,不得有任何例外。 ``` 或者更强力版: ``` You are now style-locked to the rules in CLAUDE.md at project root. Before writing any code, mentally verify compliance with every rule listed. If any rule is violated, correct it before final output. 

以上就是小编整理的全部内容,希望对您有帮助,

相关标签:

claude code skills