@umacloud/knowledge 1.0.1

package/development/01-standards/jest-complete.md

@@ -0,0 +1,275 @@
+---
+id: jest-complete
+title: Jest测试框架完整指南
+domain: development
+category: 01-standards
+difficulty: intermediate
+tags: [complete, development, jest, react测试, 学习路径, 最佳实践, 核心概念, 概述]
+quality_score: 70
+last_updated: 2026-06-15
+---
+# Jest测试框架完整指南
+
+## 概述
+Jest是JavaScript测试框架,专注于简单性和性能。本指南覆盖Jest配置、匹配器、模拟和最佳实践。
+
+## 核心概念
+
+### 1. 基础测试
+
+**简单测试**:
+```javascript
+// math.js
+function add(a, b) {
+  return a + b;
+}
+
+module.exports = { add };
+
+// math.test.js
+const { add } = require('./math');
+
+test('adds 1 + 2 to equal 3', () => {
+  expect(add(1, 2)).toBe(3);
+});
+
+test('adds -1 + 1 to equal 0', () => {
+  expect(add(-1, 1)).toBe(0);
+});
+```
+
+### 2. 匹配器(Matchers)
+
+**常用匹配器**:
+```javascript
+test('common matchers', () => {
+  const value = 2 + 2;
+  
+  // 相等
+  expect(value).toBe(4);
+  expect(value).toEqual(4);
+  
+  // 真值
+  expect(value).toBeTruthy();
+  expect(0).toBeFalsy();
+  expect(null).toBeNull();
+  expect(undefined).toBeUndefined();
+  
+  // 数字
+  expect(value).toBeGreaterThan(3);
+  expect(value).toBeLessThan(5);
+  
+  // 字符串
+  expect('hello').toMatch(/hello/);
+  expect('hello world').toContain('world');
+  
+  // 数组
+  expect([1, 2, 3]).toContain(2);
+  expect([1, 2, 3]).toHaveLength(3);
+});
+```
+
+### 3. 异步测试
+
+```javascript
+// async.js
+function fetchData() {
+  return new Promise((resolve) => {
+    setTimeout(() => {
+      resolve({ data: 'hello' });
+    }, 100);
+  });
+}
+
+// async.test.js
+test('async data', async () => {
+  const data = await fetchData();
+  expect(data).toEqual({ data: 'hello' });
+});
+
+test('async with resolves', () => {
+  return expect(fetchData()).resolves.toEqual({ data: 'hello' });
+});
+```
+
+### 4. Mock和Spy
+
+**Mock函数**:
+```javascript
+// user.js
+const fetchUser = () => {
+  return fetch('/api/user');
+};
+
+// user.test.js
+test('mock fetch', async () => {
+  global.fetch = jest.fn(() =>
+    Promise.resolve({
+      json: () => Promise.resolve({ name: 'Alice' })
+    })
+  );
+  
+  const user = await fetchUser();
+  expect(user.name).toBe('Alice');
+  expect(fetch).toHaveBeenCalledTimes(1);
+});
+```
+
+**SpyOn对象**:
+```javascript
+const video = {
+  play() {
+    return 'playing';
+  }
+};
+
+test('spy on method', () => {
+  const spy = jest.spyOn(video, 'play');
+  video.play();
+  
+  expect(spy).toHaveBeenCalled();
+  expect(spy).toHaveReturnedWith('playing');
+});
+```
+
+### 5. 测试前后钩子
+
+```javascript
+let database;
+
+beforeAll(() => {
+  // 所有测试前执行一次
+  database = connectDatabase();
+});
+
+afterAll(() => {
+  database.close();
+});
+
+beforeEach(() => {
+  // 每个测试前执行
+  database.clear();
+});
+
+afterEach(() => {
+  // 每个测试后执行
+  database.save();
+});
+
+test('test 1', () => {
+  database.insert('data');
+  expect(database.count()).toBe(1);
+});
+```
+
+### 6. 参数化测试
+
+```javascript
+test.each([
+  [1, 1, 2],
+  [1, 2, 3],
+  [2, 2, 4],
+])('add(%i, %i) = %i', (a, b, expected) => {
+  expect(add(a, b)).toBe(expected);
+});
+```
+
+### 7. 快照测试
+
+```javascript
+test('snapshot', () => {
+  const user = {
+    name: 'Alice',
+    email: 'alice@example.com',
+    age: 30
+  };
+  
+  expect(user).toMatchSnapshot();
+});
+```
+
+## React测试
+
+```javascript
+import { render, screen } from '@testing-library/react';
+import UserCard from './UserCard';
+
+test('renders user card', () => {
+  render(<UserCard name="Alice" email="alice@example.com" />);
+  
+  expect(screen.getByText('Alice')).toBeInTheDocument();
+  expect(screen.getByText('alice@example.com')).toBeInTheDocument();
+});
+
+test('click handler', () => {
+  const handleClick = jest.fn();
+  render(<UserCard onClick={handleClick} />);
+  
+  screen.getByText('Click').click();
+  expect(handleClick).toHaveBeenCalledTimes(1);
+});
+```
+
+## 最佳实践
+
+### ✅ DO
+
+1. **描述性测试名**
+```javascript
+// ✅ 好
+test('user cannot register with duplicate email', () => {});
+
+// ❌ 差
+test('test1', () => {});
+```
+
+2. **一个测试一个断言**
+```javascript
+// ✅ 好
+test('user name is correct', () => {
+  const user = new User('Alice');
+  expect(user.name).toBe('Alice');
+});
+```
+
+### ❌ DON'T
+
+1. **不要测试实现细节**
+```javascript
+// ❌ 差
+test('internal state', () => {
+  expect(component._state.count).toBe(0);
+});
+
+// ✅ 好
+test('visible output', () => {
+  expect(screen.getByText('1')).toBeInTheDocument();
+});
+```
+
+## 学习路径
+
+### 初级 (1周)
+1. 基础测试
+2. 匹配器
+3. 异步测试
+
+### 中级 (1-2周)
+1. Mock和Spy
+2. React测试
+3. 快照测试
+
+### 高级 (2-3周)
+1. 自定义匹配器
+2. 测试复杂应用
+3. 性能测试
+
+---
+
+**知识ID**: `jest-complete`  
+**领域**: development  
+**类型**: standards  
+**难度**: intermediate  
+**质量分**: 94  
+**维护者**: frontend-team@umadev.com  
+**最后更新**: 2026-03-28

package/development/01-standards/linux-complete.md

@@ -0,0 +1,234 @@
+---
+id: linux-complete
+title: Linux命令行完整指南
+domain: development
+category: 01-standards
+difficulty: intermediate
+tags: [complete, development, linux, 学习路径, 最佳实践, 核心命令, 概述]
+quality_score: 70
+last_updated: 2026-06-15
+---
+# Linux命令行完整指南
+
+## 概述
+Linux命令行是系统管理和开发的核心工具。本指南覆盖常用命令、Shell脚本和最佳实践。
+
+## 核心命令
+
+### 1. 文件操作
+
+```bash
+# 列出文件
+ls -la              # 详细列表
+ls -lh              # 人类可读大小
+tree -L 2           # 树状结构
+
+# 创建/删除
+mkdir -p dir1/dir2  # 创建多级目录
+touch file.txt      # 创建文件
+rm -rf directory    # 强制删除目录
+cp -r src dest      # 递归复制
+mv old new          # 移动/重命名
+
+# 查看文件
+cat file.txt        # 查看全部
+less file.txt       # 分页查看
+head -n 10 file.txt # 前10行
+tail -f logfile     # 实时查看日志
+
+# 搜索
+find . -name "*.py"         # 按名称搜索
+grep -r "pattern" .         # 搜索内容
+grep -i "error" /var/log/*  # 不区分大小写
+```
+
+### 2. 权限管理
+
+```bash
+# 修改权限
+chmod 755 script.sh      # rwxr-xr-x
+chmod +x script.sh       # 添加执行权限
+chmod -R 644 directory   # 递归修改
+
+# 修改所有者
+chown user:group file
+chown -R user:group dir
+
+# 查看权限
+ls -l file.txt
+# -rwxr-xr-x 1 user group 1234 Jan 1 12:00 file.txt
+```
+
+### 3. 进程管理
+
+```bash
+# 查看进程
+ps aux                  # 所有进程
+ps aux | grep python    # 过滤进程
+top                     # 实时监控
+htop                    # 增强版监控
+
+# 后台运行
+nohup python app.py &   # 后台运行
+bg                      # 后台运行
+fg                      # 前台运行
+jobs                    # 查看任务
+
+# 结束进程
+kill PID                # 优雅终止
+kill -9 PID             # 强制终止
+pkill -f "python"       # 按名称终止
+```
+
+### 4. 网络命令
+
+```bash
+# 连接测试
+ping google.com
+curl -I https://example.com
+wget https://example.com/file
+
+# 端口查看
+netstat -tulpn          # 查看端口
+ss -tulpn               # 现代版
+lsof -i :8000           # 查看端口占用
+
+# SSH
+ssh user@server.com
+scp file.txt user@server:/path/
+rsync -avz local/ user@server:/remote/
+```
+
+### 5. 磁盘管理
+
+```bash
+# 查看磁盘
+df -h                   # 磁盘使用
+du -sh directory        # 目录大小
+du -h --max-depth=1     # 逐层查看
+
+# 挂载
+mount /dev/sdb1 /mnt
+umount /mnt
+```
+
+### 6. 压缩解压
+
+```bash
+# tar
+tar -czf archive.tar.gz dir/    # 压缩
+tar -xzf archive.tar.gz         # 解压
+
+# zip
+zip -r archive.zip dir/
+unzip archive.zip
+
+# 查看压缩包
+tar -tzf archive.tar.gz
+unzip -l archive.zip
+```
+
+### 7. Shell脚本
+
+```bash
+#!/bin/bash
+
+# 变量
+NAME="Alice"
+echo "Hello, $NAME"
+
+# 条件
+if [ -f "file.txt" ]; then
+    echo "File exists"
+elif [ -d "dir" ]; then
+    echo "Directory exists"
+else
+    echo "Not found"
+fi
+
+# 循环
+for i in {1..5}; do
+    echo $i
+done
+
+# 函数
+function greet() {
+    local name=$1
+    echo "Hello, $name"
+}
+
+greet "Alice"
+
+# 参数
+echo "Script: $0"
+echo "First arg: $1"
+echo "All args: $@"
+```
+
+## 最佳实践
+
+### ✅ DO
+
+1. **使用tab补全**
+```bash
+cd /path/to/<TAB>
+```
+
+2. **使用历史命令**
+```bash
+history | grep command
+!123  # 执行第123条命令
+```
+
+3. **使用alias**
+```bash
+alias ll='ls -lah'
+alias gs='git status'
+```
+
+### ❌ DON'T
+
+1. **不要滥用sudo**
+```bash
+# ❌ 危险
+sudo rm -rf /
+
+# ✅ 谨慎使用
+sudo rm -rf /specific/path
+```
+
+2. **不要忽略错误**
+```bash
+# ❌ 差
+rm file.txt
+
+# ✅ 好
+rm file.txt || exit 1
+```
+
+## 学习路径
+
+### 初级 (1-2周)
+1. 基础命令
+2. 文件操作
+3. 权限管理
+
+### 中级 (2-3周)
+1. Shell脚本
+2. 进程管理
+3. 网络命令
+
+### 高级 (2-4周)
+1. 系统调优
+2. 自动化脚本
+3. 故障排查
+
+---
+
+**知识ID**: `linux-complete`  
+**领域**: development  
+**类型**: standards  
+**难度**: beginner  
+**质量分**: 94  
+**维护者**: devops-team@umadev.com  
+**最后更新**: 2026-03-28