Go 代码规范

命名

命名中的首字母大小写,大写指明可被外部访问,小写指明私有。对于 bool 类型,首字母应该为 HasIsCanAllow

结构体

  • 驼峰,首字母根据访问控制选择大写、小写

变量

  • 变量名尽量短
    • 局部变量,c 好于 lineCounti 好于 slliceIndex
    • 方法参数,一两个字母即可
    • 全局变量,需要更多的描述信息
  • 如果使用长单词
    • 驼峰,首字母根据访问控制选择大写、小写

包名

  • 包中所有名称引用都会使用包名,所以可以简化引用的名称,如使用 chubby.File 代替 chubby.ChubbyFile

文件

  • 小写单词
  • 下划线 _ 分隔

注释

1
2
3
4
5
6
7
8
9
// Package math provides basic constants and mathematical functions.
package math

/*
Package template implements data-driven templates for generating textual
output such as HTML.
....
*/
package template

java stream

collect

group + toMap

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
class Info {
final String key;
final String value;

Info(String key, String value) {
this.key = key;
this.value = value;
}

public String getKey() {
return key;
}

public String getValue() {
return value;
}

@Override
public String toString() {
return "Info{" +
"key='" + key + '\'' +
", value='" + value + '\'' +
'}';
}
}

List<Info> infos = new ArrayList<>();
infos.add(new Info("A", "B"));
infos.add(new Info("C", "D"));
Map<String, String> mp = infos.stream().collect(Collectors.toMap(Info::getKey, Info::getValue));
System.out.println(mp);

// 以 Info 的 key 值进行分组
Map<Info, Map<String, String>> data = new HashMap<>();
data.put(new Info("A", "A"), new HashMap<>());
data.put(new Info("A", "B"), new HashMap<>());
data.put(new Info("A", "C"), new HashMap<>());
data.put(new Info("B", "A"), new HashMap<>());
data.put(new Info("B", "B"), new HashMap<>());
data.put(new Info("B", "C"), new HashMap<>());
Map<String, Map<Info, Map<String, String>>> rd = data.entrySet()
.stream()
.collect(Collectors.groupingBy(kv -> kv.getKey().getKey(),
Collectors.toMap(Map.Entry::getKey, Map.Entry::getValue)));
System.out.println(rd);

// output
{A=B, C=D}
{A={Info{key='A', value='B'}={}, Info{key='A', value='A'}={}, Info{key='A', value='C'}={}}, B={Info{key='B', value='A'}={}, Info{key='B', value='B'}={}, Info{key='B', value='C'}={}}}

group + mapping

1
2
3
4
5
6
7
8
9
10
11
12
13
// 以 Pair.left group,并合并 Pair.right
List<Pair<String, Map<String, String>>> data = new ArrayList<>();
data.add(Pair.of("A", new HashMap<String, String>(){{put("B", "C");}}));
data.add(Pair.of("D", new HashMap<String, String>(){{put("E", "F");}}));
Map<String, Map<String, String>> r = data.stream().collect(Collectors.groupingBy(Pair::getLeft, Collectors.mapping(Pair::getRight,
Collector.of(HashMap::new, Map::putAll, (x, y) -> {
x.putAll(y);
return x;
}))));
System.out.println(r);

// output
{A={B=C}, D={E=F}}

makefile 使用

格式

1
2
3
4
target ... : prerequisites ...
command
...
...

这里 target 无实际意义,类似于定义 scrope / function。

使用

PHONY

定义虚假文件,避免和时间文件冲突,同时可以解决 make: Nothing to be done for *** 的异常。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
➜  mf touch test       # 创建空白文件 test
➜ mf cat Makefile # 打印 Makefile
test:
ls
➜ mf make test # 执行 test 目标
make: 'test' is up to date. # Makefile 的 target 默认为文件,无法对应 Makefile 中定义的 test target
➜ mf vim Makefile # 添加 .PHONY: test
➜ mf cat Makefile # 打印 Makefile
.PHONY: test
test:
ls
➜ mf make test # 重新执行 target test
ls
Makefile test

定义变量

Makefile

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
VA := "I'm VA"        # 简单赋值
VB = "I'm VB" # 递归赋值
VC ?= "I'm VC" # 条件赋值,如果已定义则忽略
VC ?= "I,m VC Again" # 测试条件赋值
VA += "I'm VA's Tail" # 追加赋值,以空格
VD := "I'm VD"
VE = "I'm VE AND "$(VD) # 测试递归赋值
VD = "I'm VDD"

.PHONY: test

test:
$(eval VF="I'm VF") # 在 target 里面,这样定义变量
@echo $(VA)
@echo $(VB)
@echo $(VC)
@echo $(VD)
@echo $(VE)
@echo $(VF)

执行

1
2
3
4
5
6
7
$ make
I'm VA I'm VA's Tail
I'm VB
I'm VC
I'm VDD
I'm VE AND I'm VDD
I'm VF

不打印执行命令

Makefile

1
2
3
4
# 以 @ 开头

tgt:
@echo "HELLO"

输出

1
2
$ make
HELLO

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
DEPS_DIR:=../../../../deps
LIB_DIR:=$(DEPS_DIR)/lib
BIN_DIR:=$(DEPS_DIR)/bin
INCLUDE_DIR:=$(DEPS_DIR)/include
PATH:=$(DEPS_DIR)/bin:$(PATH)
LD_LIBRARY_PATH=$(LIB_DIR)
LIBRARY_PATH=$(LIB_DIR)
DYLD_LIBRARY_PATH=$(LIB_DIR)
CXXFLAGS=-std=c++11 -L $(LIB_DIR) -I $(INCLUDE_DIR) -Wno-unused-command-line-argument

FBF=parser lexer # bison & flex source files
PJF=driver main # for main programs
FILES=$(addsuffix .cpp, $(PJF)) # source files
OPF=$(addsuffix .o, $(PJF)) # main programs output
FBO=$(addsuffix .o, $(FBF)) # parser & lexer output file
EXE=wc

.PHONY: wc

all: wc

wc: $(FILES)
@export PATH=$(PATH) && \
export DYLD_LIBRARY_PATH=$(DYLD_LIBRARY_PATH) && \
export LIBRARY_PATH=$(LIBRARY_PATH) && \
$(MAKE) $(FBF) && \
$(MAKE) $(OPF) && \
$(CXX) $(CXXFLAGS) -o $(EXE) $(OPF) $(FBO) && \
echo "[PROCESS] compile wc done"


parser: parser.yy
@export PATH=$(PATH) && \
export DYLD_LIBRARY_PATH=$(DYLD_LIBRARY_PATH) && \
export LIBRARY_PATH=$(LIBRARY_PATH) && \
bison -v -d $< && \
$(CXX) $(CXXFLAGS) -c -o parser.o parser.tab.cc && \
echo "[PROCESS] compile parser done"

lexer: lexer.l
@export PATH=$(PATH) && \
export DYLD_LIBRARY_PATH=$(DYLD_LIBRARY_PATH) && \
export LIBRARY_PATH=$(LIBRARY_PATH) && \
flex -V && \
flex --outfile=lexer.yy.cc $< && \
$(CXX) $(CXXFLAGS) -c -o lexer.o lexer.yy.cc && \
echo "[PROCESS] compile lexer done"

clean:
@rm parser.tab.* parser.output location.hh position.hh stack.hh lexer.yy.cc \
$(FBO) $(OPF) $(EXE)

test:
@wc wc.in%

使用

1
2
3
$ make       # make all
$ make test # test
$ make clean # clean

设置并行度

1
2
# /etc/profile
export MAKEFLAGS="-j15 -l15" # 修改 15, 根据实际 cpu 核数设置

参考

如何组织一篇文章

解释性文章

  • 意图(Intent)
  • 动机(Motivation)
  • 适用性(Applicability)
  • 结构(Structure)
  • 参与者(Participants)
  • 协作(Collaborations)
  • 结果(Consequences)
  • 实现 / 范例(Implementation / Sample)
  • 已知应用(Known Uses)
  • 相关(Related)

开发文档

  • 背景
  • 现状
  • 方案设计
    • 架构
  • 详细设计
    • 协议
    • 技术细节
  • 部署方案
  • 实验方案
  • 项目排期