记录日常算法题的解题代码、思路与心得，持续积累、系统化复盘，帮助自己构建“可检索、可复用、可演进”的题解知识库。
- 系统化：以专题与难度为主线组织题目，沉淀通用解题套路与模板。
- 实战化：每道题给出可运行代码与复杂度分析，尽量附上边界用例和对拍思路。
- 复盘化：记录“为什么卡住”“如何优化”的思考过程，避免二次踩坑。
建议采用“平台 → 难度 → 题目文件夹”的层级组织；同一题的不同语言解法统一放在该题文件夹内。
.
├─ leetcode/
│ ├─ easy/
│ │ ├─ 0001_two_sum/
│ │ │ ├─ README.md # 本题题解与思路
│ │ │ ├─ solution.py # 示例：Python 解法
│ │ │ ├─ solution.cpp # 示例：C++ 解法
│ │ │ └─ solution_v2.py # 多解可追加 v2/v3 或方法名
│ │ ├─ 0239_sliding_window_maximum/
│ │ │ └─ ...
│ ├─ medium/
│ └─ hard/
├─ nowcoder/
├─ acwing/
├─ templates/ # 常用模板：并查集、单调栈/队列、前缀和、差分、二分、DP 框架等
├─ notes/ # 专题笔记、思路总结、易错点、复杂度分析
│ ├─ topics/
│ └─ mistakes/
├─ scripts/ # 辅助脚本（对拍、统计、生成目录）
└─ README.md
- 题目文件夹：
题号_题目英文蛇形- 例如：
0001_two_sum、0239_sliding_window_maximum
- 例如：
- 题解文件（文件夹内）：
- 主解：
solution.py、solution.cpp、solution.java、solution.js等 - 多解：
solution_v2.py、two_pointers.cpp、binary_search.py等
- 主解：
- 题解说明（可选）：每题文件夹内放
README.md，记录思路与复杂度。 - 备用方案（不建题目文件夹时）：可退而使用单文件命名
lc_0001_two_sum.py，但不推荐。
为便于复盘，建议每题附带简短说明。可复制下面模板到每题的 README.md 或题解顶部注释中。
# 题目：<标题>
- 平台：<LeetCode / NowCoder / ...>
- 链接：<题目链接>
- 难度：<Easy / Medium / Hard>
## 思路
- 核心：
- 关键细节：
- 边界情况：
## 复杂度
- 时间：O(...)
- 空间：O(...)
## 代码（Python 示例）
```python
from typing import List
class Solution:
def twoSum(self, nums: List[int], target: int) -> List[int]:
index_by_value = {}
for i, x in enumerate(nums):
if (target - x) in index_by_value:
return [index_by_value[target - x], i]
index_by_value[x] = i
return []
```
## 备注
- 可选：对拍脚本、对比多种写法的优缺点不同语言按需选择：
-
Python
- 直接运行：
python leetcode/easy/0001_two_sum/solution.py - 建议创建虚拟环境并使用
requirements.txt（若有）：python -m venv .venv .venv/Scripts/activate # Windows pip install -r requirements.txt
- 直接运行：
-
C++
- 编译运行：
g++ -std=c++17 -O2 -Wall leetcode/easy/0239_sliding_window_maximum/solution.cpp -o main && ./main
- 编译运行：
-
Java
- 编译运行：
javac leetcode/easy/0001_two_sum/Solution.java && java -cp leetcode/easy/0001_two_sum Solution
- 编译运行：
-
JavaScript/TypeScript
- 运行：
node leetcode/easy/0001_two_sum/solution.js或使用ts-node（TypeScript）
- 运行：
可在
scripts/中添加对拍与统计脚本（例如：随机数据生成、不同解法耗时对比、目录自动索引）。
- Python：
ruff+black - C++：
clang-format+cpplint - JavaScript/TypeScript：
eslint+prettier - Git Hooks：可使用
pre-commit统一做格式化与静态检查
推荐采用 Conventional Commits：
feat: add leetcode/easy/0001_two_sum: python solutionrefactor: leetcode/easy/0239_sliding_window_maximum: optimize using dequedocs: add notes/topics/动态规划-背包九讲
分支建议：
main：稳定可读的题解与文档feat/<topic-or-problem>：新题/新专题开发
- 每周目标：至少 4 道（覆盖 1-2 个专题）
- 专题清单（示例）：
- 基础：哈希、双指针、二分、栈/队列、链表、树/图遍历
- 进阶：滑动窗口、前缀和/差分、并查集、字典树、拓扑排序
- 动态规划：背包、区间 DP、状态压缩、数位 DP
- 经典题单复盘与错题集
- 数据统计（可选）：维护
scripts/stats.py输出完成度报表
欢迎提交 Issue/PR：
- Fork 本仓库，创建特性分支：
git checkout -b feat/xxx - 按上述目录与命名提交题解与说明
- 确保代码可运行、说明完整、通过基本测试
- 提交 PR 并简述变更
本仓库采用 MIT 协议开源。仓库根目录包含 LICENSE 文件（MIT）。
- 平台题源与社区讨论：LeetCode、牛客、AcWing 等
- 开源工具与格式化规范维护者
如果你也在刷题，欢迎交流思路与补充更优解法 🙌