## 变量和注释使用


### 变量解包

python 中可以对变量进行解构

```python
usernames = ['silon', 'sibine']

user_a, user_b = usernames
```


```python
# 可以对嵌套解构进行解构

attrs = [1, [66, 77]]

num1, (num2, num3) = attrs
```



同时可以对被解构的内容进行切片

```python
data = [1, 2, 3, 4, 5]

# 动态解构和切片赋值效果相同
a, *b, c = data

# 切片赋值
a, b, c = data[0], data[1:-1], data[-1]
```

### 变量类型注释

python 在 3.5 版本之后，提供了类型注释

类型注释用于标明变量的类型

需要注意的是：  
**类型注释只是一种注释，不提供任何校验功能**，如果需要校验类型，可以安装其他静态类型检查工具（mypy 等）


使用类型注释，可以配合 ide，得到更好的代码提示效果

```python
from typing import List
def remove_invalid(items: List[int]):
    """剔除 items 里面无效的元素"""
```


另外官方 也推荐使用 sphnix 格式的注释

```
def remove_invalid(items):
    """剔除 items 里面无效的元素
    
    :param items: 待剔除对象
    :type items: 包含整数的列表，[int, ...]
    """
```


### 变量命名规范

Python制定了官方的编码风格指南：PEP 8。这份风格指南里有许多详细的风格建议，比如应该用4个空格缩进，每行不超过79个字符，等等。其中，当然也包含变量的命名规范：

· 对于普通变量，使用蛇形命名法，比如max_value；  
· 对于常量，采用全大写字母，使用下划线连接，比如MAX_VALUE；  
· 如果变量标记为“仅内部使用”，为其增加下划线前缀，比如_local_var；  
· 当名字与Python关键字冲突时，在变量末尾追加下划线，比如class_。  


除了必须要遵守 pep8 标准，还需要保证以下要求，达到好的效果

- 描述性要强  
    要使用尽量精确的词语进行变量描述，避免使用 data、temp 等非常泛性的名称，容易与其他变量混淆
- 长度尽量短  
    可以结合上下文，进行变量名称的精简，例如可以把`how_many_points_needed_for_user_level3`直接删减成`level3_points`
- 匹配类型
    使用固定的命名格式，来表达该变量的类型
    常见组合例如：  
    
    | 类型 | 组合 |
    | --- | --- |
    | bool | is_super、 has_permission 、 allow_empty |
    | int和float| port、 age、 _cnt 、 _length |
    | list | 复数变量名: apples |
    | 其他  | 建议使用类型注释 |
    
    注意不要使用 复数格式，用于 int 类型变量
- 仅特定场景使用短命名
    
    | 场景 | 命名 |
    | --- | --- |
    | 数组索引 | i,j,k  |
    | 某个整数 | n |
    | 某字符串 | s |
    | 某异常  | e |
    | 文件对象 | fp |
- 同一段代码，不要出现多个相似变量，例如 name1，name2

    
### 注释使用规范

编写代码时，使用注释，有几个注意点

1. 不建议将注释作为临时屏蔽代码的工具  
    不要觉得注释掉的内容以后还要用，如果需要，可以从git 历史中寻找
2. 不要使用注释复述代码  
    注释作为代码之外的说明性文字，应该尽量提供那些读者无法从代码里读出来的信息。描述代码为什么要这么做，而不是简单复述代码本身。  
    错误示范：  
    ```python
    #调用strip()去掉空格
    input_string = input_string.strip(
    ```
    正确示范：
    ```python
    #如果直接把带空格的输入传递到后端处理，可能会造成后端服务崩溃
    # 因此使用strip() 去掉首尾空格
    input_string = input_string.strip(
    ```
3. 适当增加指引式注释  
    指引性注释的主要作用是降低代码的认知成本，让我们能更容易理解代码的意图。
    ```python
    #初始化访问服务的client对象
    token = token_service.get_token()
    service_client = ServiceClient(token=token)
    service_client.ready()
    # 调用服务获取数据，然后进行过滤
    data = service_client.fetch_full_data()
    for item in data:
        if item.value > SOME_VALUE:
        ...
    ```
    同时使用指引式注释，也能帮助自己梳理代码
    ```python
    service_client = make_client()
    data = fetch_and_filter(service_client)
    ```
4. 不要过度注释使用者不需了解的内容，例如编写代码的思路  


### 变量使用的建议

- 要保证变量的一致性
    - 名字一致性：不要把同一个事务，在一个系统里各处起不同的名称  
      例如 user_avatar_url, user_profile_url
    - 类型一致性：不要把同一个变量重复指向不同类型的值，应该创建新的变量来处理新的类型的值
      ```python
      def foo():
      users = {'data': ['piglei', 'raymond']}
      ...
      # 使用一个新名字
      user_list = []
      ...
      ```
- 变量的定义尽量靠近  
    不要一次性都在顶部把局部变量定义好，应该在即将使用到该临时变量时，再定义  
    好的例子如下
    ```python
    def generate_trip_png(trip):
    """
    根据旅途数据生成 PNG 图片
    """
    # 开始初始化 waypoints 数据
    waypoints = []
    waypoints.append(...)
    ...
    # 开始处理 photo_markers、text_markers
    photo_markers, text_markers = [], []
    photo_markers.append(...)
    ...
    # 开始计算 marker_count
    marker_count = 0
    marker_count += ..
    ```
- 为复杂处理，创建临时变量，提升可读性  
    最常见的就是，将复杂的条件判断，进行 flag 的赋值
    ```python
    #为所有性别为女或者级别大于3的活跃用户发放10000个金币
    user_is_eligible = user.is_active and (user.sex == 'female' or user.level > 3)
    if user_is_eligible:
        user.add_coins(10000)
    ```
- 同一作用域不要使用过多变量  
    要减少函数里的变量数量，最直接的方式是给这些变量分组，建立新的模型（数据类）
- 能不定义变量，就不定义  
    不需要过度优化，不必为了那些未来可能出现的变动，牺牲代码此时此刻的可读性。如果以后需要定义变量，那就以后再做
    ```python
    def get_best_trip_by_user_id(user_id):
        # 心理活动：嗯，这个值未来说不定会修改/二次使用，我们先把它定义成变量吧！
        user = get_user(user_id)
        trip = get_best_trip(user_id)
        result = {
            'user': user,
            'trip': trip
        }
        return result
    ```
    正确示例：  
    ```python
    def get_best_trip_by_user_id(user_id):
        return {
            'user': get_user(user_id),
            'trip': get_best_trip(user_id)
        }
    ```
- 不要使用 locals()  
    locals()是Python的一个内置函数，调用它会返回当前作用域中的所有局部变量  
    其他人在阅读代码时，为了搞明白模板渲染到底用了哪些变量，必须记住当前作用域里的所有变量  
    使用locals()还有一个缺点，那就是它会把一些并没有真正使用的变量也一并暴露

### 注释使用建议

- 适当使用空行区分代码块
- 尽量先写注释后写代码

Python 进阶 01- 变量和注释的使用

# GVM 安装指南

GVM（Go Version Manager）是一个用于管理 Go 语言版本的工具，可以让你方便地在多个 Go 版本之间切换。本文将介绍如何在你的系统上安装 GVM。

[官方项目地址](https://github.com/moovweb/gvm)





## 前期准备

### 在 macOS

```
xcode-select --install
brew update
brew install mercurial
```

### debian 或 ubuntu
```
sudo apt-get install curl git mercurial make binutils bison gcc build-essential
```

### 其他 linux 发行版本
[查看官方文档](https://github.com/moovweb/gvm)


## 安装 GVM

1. **打开终端**。

2. **输入以下命令下载并安装 GVM**：

```bash
bash < <(curl -s -S -L https://raw.githubusercontent.com/moovweb/gvm/master/binscripts/gvm-installer)
```

![image.png](https://oss.silon.vip/img/d80019f9f147d5bfde2898b3cb4f4876.image.webp)

3. **激活 GVM**：

   安装后，你需要将 GVM 的初始化脚本添加到你的 Shell 配置文件中。根据使用的 shell 类型，选择相应的配置文件：

    对于 **bash** 用户：
     ```bash
     source /Users/silon/.gvm/scripts/gvm
     source ~/.bashrc
     ```

    对于 **zsh** 用户：
     ```bash
     source /Users/silon/.gvm/scripts/gvm
     source ~/.zshrc
     ```
 
4. **验证安装**：

   你可以通过运行以下命令来验证 GVM 是否已正确安装：

   ```bash
   gvm version
   ```

   如果安装成功，你将看到 GVM 的版本信息。
 
![image.png](https://oss.silon.vip/img/755a82122592daeffd7674d1fc5a7ce3.image.webp)
 

# 使用 GVM 管理 Go 版本

安装后，你可以使用以下命令来管理 Go 语言版本：

1. **列出可用的 Go 版本**：

   ```bash
   gvm listall
   ```

2. **安装指定版本的 Go**：

   例如，要安装 Go 1.17：

   ```bash
   gvm install go1.17
   ```

3. **使用指定的 Go 版本**：

   使用以下命令激活已安装的 Go 版本：

   ```bash
   gvm use go1.17
   ```

4. **查看当前使用的 Go 版本**：

   可以通过以下命令查看当前激活的 Go 版本：

   ```bash
   go version
   ```

## 示例

假设你想安装并使用 Go 的最新稳定版 1.20。可以按照以下步骤操作：

1. 使用 GVM 安装 Go 1.20：

   ```bash
   gvm install go1.20
   ```

2. 使用 Go 1.20：

   ```bash
   gvm use go1.20
   ```

3. 验证当前版本：

   ```bash
   go version
   ```

以上步骤应该能顺利地让你在 macOS 上使用 Homebrew 安装和使用 GVM 以及管理 Go 版本。


![image.png](https://oss.silon.vip/img/200f1e9b66ab9e2bd3fc0d3926d60b4d.image.webp)


# 卸载 GVM

如果你需要卸载 GVM，可以使用以下命令：

```bash
rm -rf $HOME/.gvm
```

并记得从你的 shell 配置文件中删除 GVM 的初始化脚本。

golang 多版本管理器 gvm

## 问题说明

vite 中已经配置了 @ 路径
```ts
  resolve: {
    alias: {
      '@': resolve(__dirname, "./src"),
    }
  }
```
并且路径已经可以识别，但是编辑器提示ts无法识别

![image.png](https://oss.silon.vip/img/515720c5c8e0294e642f6e7a04f846b9.image.webp)

## 解决方法

修改ts检查配置，找到tsconfig.json 或其引用的配置文件，对 `compilerOptions` 项中添加`path`配置

```
"compilerOptions": {
    /* 项目自定义配置 */
    "paths": {
      "@/*": ["./src/*"]
    },
}
```

vite 中设置@ 路径，ts报错 2307

## 解决办法：

1、在github desktop中，点击"File"-"Options"；

2、在弹出的页面中，点击左侧的"Git"；

3、在"Git"对应的右侧，点击"edit your global Git config file."；





![image.png](https://oss.silon.vip/img/8e2dba3cae4e6725fcf3fe3c61ab3acd.image.webp)

4、在打开的.gitconfig文件中，增加如下内容

```
[core]
autocrlf = false
```

![image.png](https://oss.silon.vip/img/c981e81b3fe67cc1f8fe1a755d2b39b3.image.webp)


5、回到弹出页面，点击"Save"


![image.png](https://oss.silon.vip/img/edd013591a426b90d668fa09c4367881.image.webp)

github desktop 提示This diff contains a change in line endings from ‘LF‘ to ‘CRLF‘.

## iss 语法参考
[语法参考](https://blog.csdn.net/qq_41142992/article/details/139726536)

[语法使用参考](https://zhuanlan.zhihu.com/p/168690637)





## iss 文件结构
```
//宏定义段

[Setup]

[Types]

[Components]

[Tasks]

[Dirs]

[Files]

[Icons]

[INI]

[Languages]

[Messages]

[CustomMessages]

[LangOptions]

[Registry]

[Run]

[UninstallDelete]

[UninstallRun]

[Code]
```

## 安装顺序

```
[Dir]

[Files]

[Icons]

[INI]

[Registry]

[Run]（PS:对于使用Flags:postinstall的项需要特别注意）
```

## 常用语法

### 宏定义

宏定义即该脚本的全局变量

定义方式
```
#define MyAppName "MyApp"
#define MyVersion "3.2.5.872"
```

调用方式
```
{#MyAppName}
{#MyAppVersion}
```

### Setup 全局设置

```
[Setup]
//每个安装程序的AppId都不同，用于区分不同的程序
AppId={{E7388416-72E3-4077-9F1E-025AE6E5AAA1}
//应用程序名称
AppName={#MyAppName}
//应用程序版本
AppVersion={#MyAppVersion}
AppPublisher={#MyAppPublisher}
//默认安装路径，autopf 即当前用户的 programfiles 文件夹
DefaultDirName={autopf}\{#MyAppName}
//安装/卸载后刷新文件关联信息
ChangesAssociations=yes
//安装程序将不显示“选择开始菜单文件夹”向导页
DisableProgramGroupPage=yes
//安装包输出目录路径
OutputDir={#BasePath}\release\AppSetup_{#MyAppVersion}
//安装文件名称
OutputBaseFilename=AppV3ServerSetup_{#MyAppVersion}
//压缩算法，基于压缩率和压缩/解压缩速度权衡，推荐zip算法
Compression=zip
//是否启用固态压缩（将所有文件进行一次压缩，提升压缩率），默认no
SolidCompression=yes
//安装程序外观风格，默认classic 
WizardStyle=modern
//以管理员权限安装
PrivilegesRequired=admin
//对于安装包大小大于2,100,000,000 bytesd(2GB)的情况下，需要开启该选项，将生成一个setup.exe以及多个bin文件，分片
DiskSpanning=yes
//安装包的图标
SetupIconFile=E:\部署环境\app\server\256.ico
//鼠标悬浮-文件版本
VersionInfoVersion={#MyVersion}
//鼠标悬浮-公司信息
VersionInfoCompany={#MyCompany}
//鼠标悬浮-程序版本
VersionInfoProductVersion={#MyVersion}
//鼠标悬浮-程序名称
VersionInfoProductName={#MyProductName}
//鼠标悬浮-版权
AppCopyright={#MyAppCopyright}
```

### Types 安装类型 + Components 安装组件

#### Types

安装程序将显示在向导的选择组件页面上的所有安装类型，一般用于自定义安装，与`[Components]`配合使用

` Flags: iscustom` 表示该类型是自定义类型。

用户在安装过程中手动更改组件选择时，安装程序都会将安装类型设置为自定义类型。

如果不定义自定义类型，安装程序将只允许用户选择安装类型，他们不能再手动选择/取消选择组件。


```
[Types]
Name: "full"; Description: "完整安装所有组件"
Name: "onlyInstallServiceA"; Description: "仅安装服务A"
Name: "onlyInstallSeeviceB";Description:"仅安装服务B"; 
Name: "custom ";Description:"自定义安装组件"; Flags: iscustom
```

#### Components

这里的 Types 即上面定义过得 Types

```
[Components]
Name: "main"; Description: "系统运行的最小单元"; Types: full ; Flags: fixed
Name: "main\client"; Description: "服务A"; Types: onlyInstallServiceA custom; Flags: fixed
Name: "main\server"; Description: "服务B"; Types: onlyInstallServiceB custom; Flags: fixed
Name: "tools"; Description: "工具"; Types: full custom
Name: "tools\backups"; Description: "数据备份工具"; Types: full custom
Name: "tools\logs"; Description: "日志处理工具"; Types: full custom
```


![image.png](https://oss.silon.vip/img/7584d38f9d1b005575705a69ec7749fa.image.webp)


### 安装任务 Tasks

安装程序在安装过程中将执行的所有用户可选任务

相关参数：

`Components`: 关联的组件，只有用户在上一步选择了该组件，这一步才会展示该任务

`Flags`: 
  - exclusive : 是否其他任务互斥

```
[Tasks]
Name: "resetDateDir"; Description: "重新选择数据存储目录"; GroupDescription: "修改配置信息:";
Name: "autoBackupCases"; Description: "安装前自动备份案件数据"; GroupDescription: "案件数据:"; Components: tools\backups

Name: "restart"; Description: "安装完成后自动重启电脑"; Flags:exclusive 
Name: "autoOpenClient"; Description: "安装完成后自动打开客户端"; Flags:exclusive
```


### 创建目录 Dirs

安装程序除了用户选择的应用程序目录(该目录是自动创建的)之外要创建的任何其他目录

相关参数：

`Attribs`: 目录的其他属性
 - readonly, hidden, system, notcontentindexed

`Flags`:
- deleteafterinstall
    - 如果安装之前目录不存在，且安装完成(或中止)后目录为空，则在安装完成(或中止)后将其删除。

- uninsalwaysuninstall
    - 安装完成(或中止)后目录为空，则在安装完成(或中止)后将其删除。

- uninsneveruninstall
    - 卸载程序不删除目录。默认情况下，如果[ Dirs ]部分中指定的目录为空，卸载程序将删除该目录。


```
[Dirs]
Name: "{app}\data"; Attribs: readonly; Flags: "deleteafterinstall"
Name: "{app}\bin"
```

### 创建文件 Files

安装程序要安装在用户系统上的文件

相关参数：

`DestName`:
- 此参数指定文件在用户系统上安装时的新名称。默认情况下，安装程序使用 Source 参数中的名称，因此在大多数情况下不需要指定此参数。

`Excludes`:
- 指定要排除的模式列表，以逗号分隔。此参数不能与 external 组合。

```
Source: "{#BasePath}\jre\*"; DestDir: "{app}\jre"; Excludes: "*.txt"; Flags: ignoreversion recursesubdirs createallsubdirs
```

`Flags`
- confirmoverwrite: 在替换现有文件之前，始终要求用户确认。

- createallsubdirs: 默认情况下编译器在递归搜索 Source 文件名/通配符（例如 jre\*）时会跳过空目录。这个标志会在安装时创建这些目录，必须与recursesubdirs一起使用

- deleteafterinstall: 安装后删除，如果安装前文件存在，且未替换，则不删除，不能与isreadme, regserver, regtypelib, restartreplace, sharedfile， uninsneveruninstall一起使用

- dontverifychecksum: 安装程序在提取后,不验证文件校验和。对已编译到安装程序中但希望修改的文件使用此标志。与nocompression一起使用

- isreadme: 文件是“ README”文件。安装中只有一个文件可以有这个标志。当一个文件有这个标志时，会出现一个选项，是否希望在安装完成后查看 README 文件。如果选择“是”，安装程序将打开该文件。对文件后缀有要求.txt, .wri, .doc

- nocompression: 不进行压缩

- onlyifdoesntexist: 只有当文件在用户系统上不存在时才安装该文件。

- recursesubdirs: 递归Source指定的目录

- replacesameversion:用户的系统中已经存在该文件，并且版本号相同时，并且文件内容不同时，才替换该文件。PS:默认行为情况下，不替换具有相同版本号的现有文件。

- uninsneveruninstall:不删除文件


```
[Files]
Source: "D:\code\local\打包\abc.reg"; DestDir: "{app}"; Flags: ignoreversion
Source: "D:\code\local\打包\test.txt"; DestDir: "{app}"; Flags: ignoreversion
Source: "D:\code\local\打包\test.mp4"; DestDir: "{app}"; Flags: ignoreversion
```

### 注册表 Registry

用于在用户系统中创建，修改或删除注册表健值

```iss
[Registry]
Root: HKLM; Subkey: "Software\YourCompanyName\YourApplicationName"; ValueType: string; ValueName: "SomeValue"; ValueData: "SomeData"; Flags: uninsdeletevalue; MinVersion: 0,6.1
```

- `Root`指定了注册表项的根键
- `Subkey`指定了注册表项的路径
- `ValueType`指定了注册表值的类型
- `ValueName`指定了注册表值的名称
- `ValueData`指定了注册表值的数据
- `Flags`指定了卸载时是否删除该注册表值
- `MinVersion`指定了最低支持的Inno Setup版本


| Root | 注册表Root key |
| --- | --- |
| HKCU	| (HKEY_CURRENT_USER)
| HKLM	| (HKEY_LOCAL_MACHINE)
| HKCR	| (HKEY_CLASSES_ROOT)
| HKU	| (HKEY_USERS)
| HKCC	| (HKEY_CURRENT_CONFIG)
| HKA	| 在管理员权限运行时为HKLM，否则为HKCU


| ValueType |	注册表   |
| --- | --- |
| none	| 创建键，但不创建值
| string |	REG_SZ
| expandsz |	REG_EXPAND_SZ
| multisz |	REG_MULTI_SZ
| dword |	REG_DWORD
| qword |	REG_QWORD
| binary |	REG_BINARY


## 实用示例

### 创建注册表

创建一个注册表，并修改里面的键值对
```iss
[Registry]

Root: HKLM; Subkey: "SOFTWARE\Demo"; Flags: uninsdeletekeyifempty
Root: HKLM; Subkey: "SOFTWARE\Demo"; ValueType: dword; ValueName: "LOADCTRLS"; ValueData: $00000002; Flags: uninsdeletevalue
Root: HKLM; Subkey: "SOFTWARE\Demo"; ValueType: string; ValueName: "DESCRIPTION"; ValueData: "xxxx模块"; Flags: uninsdeletevalue
```

### 安装时创建指定文件

举例：安装时，创建一个文件，内容为当前系统用户的默认下载路径

```iss
[Code]
function GetUsername: String;
begin
  Result := ExpandConstant('{%USERNAME}');
end;

procedure WriteProfileIni;
var
  ProfileContent: TStringList;
begin
  ProfileContent := TStringList.Create;
  try
    ProfileContent.Add('CurrentUserDownloadPath = "C:\Users\' + GetUsername + '\Downloads"');
    ProfileContent.SaveToFile(ExpandConstant('{app}\profile.ini'));
  finally
    ProfileContent.Free;
  end;
end;

procedure CurStepChanged(CurStep: TSetupStep);
begin
  if CurStep = ssPostInstall then
  begin
    WriteProfileIni;
  end;
end;
```

### 卸载时删除指定文件

此处 `{app}` 为安装目录，打包程序能够自动识别
```iss
[UninstallDelete]
Type: filesandordirs; Name: "{app}\profile.ini"
```