edit csv插件的使用说明

使用vscode时遇到了一个问题：打开csv文件总是需要回到桌面打开文件资源管理器利用excel软件打开csv文件，而利用vscode直接打开又不能很好的展现。（全是逗号分隔的，没有表格）于是发现了这款宝藏插件：edit csv。由于该插件是英文模式，所以一些功能在这里说明一下。

edit csv插件图标

插件打开

使用该插件前必须打开csv文件，接着鼠标右键点击该文件，点击Edit CSV选项即可使用该插件打开csv文件。

本文从三个方面来讲该插件的使用，分为红色区域、绿色区域和黄色区域。

黄色区域

该区域是绿色区域最左边的小箭头下拉出来的。

• Number sum  

The sum of numbers in the selected cells(only connected cells). Only the first number of a cell is used. Arbitrary-precision is powered by big.js

 该项统计的是选中的单元格中的数字综合。但是所选单元格必须是一次选择的，区别于使用ctrl键和鼠标多次选择，如果多次选择，那么就以最后选中的那一次为准。

• Selected cells

The number of selected cells

 该项统计的是选中的区域单元格个数

• Not empty

The selected cells count where the value is not empty(whiltespace is counted as value)

 所选不为空的单元格个数（空格也被视为非空）

• Selected row

The selected rows count

 所选单元格的行数

• Selected cols

The selected columns count

 所选单元格的列数

• Rows count

右侧所有表格区域的行数

• Cols count

右侧所有表格区域的列数

• Numbers style

The number style only applies for the stats, does not affect sorting! Change before selecting cells.

        en:3.14 这种模式下点号表示小数点，用空格或逗号来分隔千位

        non-en:3,14 这种模式下反过来，逗号表示小数点 ，空格或点号分割千位

这两种模式可能只是影响求和计算，但对于排序没有区别。

补充： 这两种数字格式是为有习惯差异的国家转换使用的，可见该插件的考虑情况还挺完善的。

大家可以阅读这篇文章来了解一下这种差异：部分国家数字分隔符形式之辨 | True Words

 红色区域

这块红色区域分为左中右三部分来阐述。

左 :Read options

• has header

The first row is used as header.Note that changing this option will also change the write header option. It will also clear the undo/redo stack! If the table has only one row this cannot be applies immediately, it will be applied if the table has more than 1 rows.

如果第一行是标题行，就勾选这个选项，那么它就从第一行转变成了标题行 ，统计的行数也就少了一个。

注意：

1. 执行此操作会清除撤销(undo)和重做(redo)栈，也就是不能再进行撤销、重做等相关操作了。
2. 如果表格只有一行，那么勾选这个选项会出现bug
3. 勾选此选项的同时，write options中的write header选项也会同时勾选。

• Delimiter

Empty to auto detect(detected:,)

 该选项意为分隔符。我们知道csv文件全称为Comma-Separated Values，翻译为中文为逗号分隔值，该文本是以纯文本（数字和文本）形式存储表格数据的。纯文本意味着该文件是一个字符序列，不含必须像二进制数字那样被解读的数据。CSV文件由任意数目的记录组成，记录间以某种换行符分隔；每条记录由字段组成，字段间的分隔符是其它字符或字符串，最常见的是逗号或制表符。通常，所有记录都有完全相同的字段序列。

所以该选项是设置使用哪一种符号作为分隔符去解读csv文，一般选择auto选项。

• comment

Comments before and after csv data are preserved. Comments between data rows are ignored. Empty to treat every line as data(no comments).

CSV数据前后的注释会被保留。数据行之间的注释会被忽略。如果选择“空”（Empty），则每一行都被视为数据（无注释）。

这个用法会结合下边的一个按钮（Hide comments）来使用，空行中填写的是注释标识符，也就是告诉电脑这个符号开头的都是注释，然后点击下边那个按钮就会将以该符号开头的一行表格隐藏起来。如果该行填写什么也没有填写的话，就会展现所有的行。

• QuoteChar

该字符是字段值的边界符号。当csv文件中的一个字段中包含有分隔符，换行符时，需要使用quotechar包含起来。比如说，如果一字段是a，那么它就需要使用引号（quotechar一般是引号）引起来以便于分隔识别。

• Escapechar

该字符是转义字符。在字段中既含有分隔符也含有quotechar或者escapechar本身时使用。

注：如果字段中含有分隔符，必然要使用quotechar。escapechar这个东西有点绕，对于结尾是escapechar可能还会报错。所以这里建议在表格中先写上最终展示的结果，然后点击下面的一个按钮"Apply changes to file and save"，回到原csv文件中去看什么表达，但是注意这中情况下的quotechar和escapechar是默认的引号。

• Reset data and apply read options

The input file content was stored locally and is used as data. Thus this view is independent of the source file.

该选项意思是如果改变了read options中的一些设置的话，那么它就会按照新的设置重新加载源文件，与此同时，如果你首次加载后修改了一些数据那么也会丢失掉。
 

中:Write options

该区域的功能和Read options差不多，是为了在表格上有所修改之后，需要重新应用到csv源文件时设置的。比如说：Writer header选项是为了应用到源文件时是否显示标题行；再比如说：Quote all fields是设置每个字段是否加上quotechar设置的符号，等等。

右 :

• Preview

该功能是预览功能。比如说一个比较大的csv文件右1000行，可能第一次展示的只有400行，点击preview可以继续展现一部分。

• 

refresh preview

该功能是刷新预览。

• 

creates the preview and copies it to the clipboard

该功能会将预览内容显示在下边的粘贴板上，方便大致浏览内容。

• 

Redraws the table. This can  fix some measuring issues(e.g. after the font size changed)

 该功能会重新绘制表格。在某些情况下，如字体大小改变后，可能会遇到一些测量问题（例如，单元格大小、文本对齐方式等可能不再准确）。通过重新绘制表格，可以修复这些问题，确保表格的显示正确无误。

• 

Resizes all column widths to match their content

 该功能会自动调整所有列的宽度，以确保每列的宽度恰好适应其内容。换句话说，它会根据每列中最长单元格的内容来确定列的宽度，从而避免内容被截断或单元格之间有不必要的空白空白。类似于Excel中双击列表分界线处，当然在该插件中双击列分界线处也是具有此功能的。

• 

Resizes all row heights to match their content

和上一个功能类似，该功能是上下调整宽度。

• 

Reload the csv file content(from disk)

从csv源文件中重新加载。 

• 

Set fixed rows top

这一功能描述的含义是，用户可以将指定的行设置为固定行，并使这些行始终显示在表格的顶部。这种功能在处理包含大量数据的CSV表格时尤其有用，因为它允许用户将标题行、总计行或其他关键信息行固定在顶部，以便在滚动浏览数据时，这些重要信息始终可见。

点击后， 该图标右侧会出现fixed rows字样，点击上下箭头可以控制前几行固定在表格顶部。

• 

Set fixed columns left 

该功能和上一个类似，将前几列固定在左侧。

•  

Sets the table to readonly mode

开启（关闭）编辑模式 

• 

Resets the table content zoom

放大缩小表格。利用 ctrl+鼠标滚轮也可以实现相同的功能。

• 

如果你修改过表格的话，该按钮会出现，提示你可能没有保存更改的部分。

绿色区域

• Add row

在当前选中的一行前/后插入一行。点击右侧上箭头是在上侧插入，反之则是在下侧插入。

• Add column

在当前一列前/后插入一列。左侧箭头是前插，反之是后插。

• Apply changes to file and save

Applies the csv content back to the source file and saves the source file(if something changed)

将CSV内容重新应用到源文件，并在内容有所更改时保存源文件。

• Apply changes to the file

Apply the csv content back to the source file (if something changed).After this the editor has no unsaved changes.

将csv内容重新应用到源文件，之后该文件就没有未保存的部分（就是上边所说过的右上角没有了提醒保存的按钮了） 

• Hide comments

隐藏以注释开头的一行，并且隐藏后会有一个小箭头提示该行隐藏了。

• Tools

1. Trim   删除单元格（包括标题行）中前后的空格、tab等。但这会清除撤销记录。
2. Transpose 单元格转置，同样会清除撤销记录。

• Helps

功能/快捷键

• 撤销/重做：未提供具体快捷键，但通常撤销为Ctrl+Z，重做为Ctrl+Y（或Ctrl+Shift+Z）。
• 点击列头文本排序：点击列头可以对列进行排序。
• 选择并拖动重新排列：点击行/列头文本左侧的空白处，然后拖动以重新排列。
• 调整行/列大小：通过拖动行/列边缘的调整手柄来调整大小。
• Home/End键：Home键移动到行中的第一个单元格，End键移动到行中的最后一个单元格。
• Ctrl+Home/Ctrl+End：Ctrl+Home移动到列中的第一个单元格，Ctrl+End移动到列中的最后一个单元格。
• Esc键：取消编辑并关闭单元格编辑器。
• Ctrl+Enter：在单元格中添加换行符。
• 删除行/列：将鼠标悬停在行/列上，点击垃圾桶图标删除。
• 双击调整列宽：双击列的调整手柄以适应内容，双击自动调整的列将宽度设置为200px。
• 更多快捷键：访问Handsontable官方文档查看完整快捷键列表。

使用提示

• 排序更新：数据更改后排序不会自动更新。
• 排序状态导出：排序状态会被导出。
• 复制单元格值：类似于Excel，按住Alt键后释放鼠标按钮可以复制单元格值，不进行插值。
• 多列排序：使用Ctrl/Cmd点击列头进行多列排序。
• 未保存更改指示器：任何更改都会显示未保存更改指示器（直到应用更改，即使手动恢复也不会清除）。
• 加载后显示未保存更改：加载表格后立即显示未保存更改指示器，可能是因为某些行被展开以确保所有行长度相同。
• 右键菜单：在表格上右键点击获取上下文菜单。
• 隐藏行/列导出：隐藏的行/列也会被导出。
• 注释行：注释行只会导出第一个单元格/列。如果使用除第一个单元格以外的单元格进行注释，单元格颜色将指示这一点。
• 编辑未命名文件：编辑未命名的（csv）文件并关闭它，编辑器也会关闭（未保存的更改将丢失）。
• 复制粘贴：使用制表符（⇥）作为分隔符（与Excel相同）。
• 不能更改换行符：因为VS Code可能会自动将其转换为文件设置。
• 行单元格匹配：如果一行比其他行有更多的单元格，则会添加空单元格以匹配具有最多单元格的行。
• 扩展配置：仅应用于新编辑器。
• 删除多行/列：通过Shift和右键点击选择它们，然后删除（或使用Ctrl+Shift+Alt+Minus）。

以上均为个人见解，如有错误，请不吝赐教。

如果大家有补充的话，请评论区多多指教。