术语表讨论确定

[ShenQingchuan]

这个 issue 帖用于讨论确定本文档中的术语表。

在翻译团队审阅完目前的全部文档内容后，这个置顶帖会统计和罗列最终确定的结果。

任何疑问、意见或建议都可以通过在此 issue 下方跟帖来提出。

最终敲定表

这里汇总的是本 issue 帖中的意见归纳，可能和现有已确定的术语表有重合。

英文原词	词性	中文翻译意见	备注
hydration	n.	激活	vuejs/docs-next-zh-cn#786
caveats	n.	注意事项

[wxsms]

贴一下 原术语约定。

[Jinjiang]

我核实了一下 mixin 和 effect 算是和之前 wiki 里整理的内容是吻合的

• mixin 不翻译 #350、#382
• hydration 印象中也许很早的时候 v2 或 ssr 的文档里出现过水合的译法，但早已经没有在用了，最近的讨论结果是“激活”，印象中小右当时也线下参与了的讨论 #786
• effect 在特指“effect scope”的时候保留英文，即“effect 作用域”，其它一般化自然语言描述的情况下译为“作用”，例如“side effect”译为副作用 #657

[Justineo]

关于 effect 原来的 wiki 里有一个地方要改：effect flush timing 要从副作用刷新时机改为 effect 刷新时机（不过其实这一条感觉不需要在 wiki 里单列出来了）。

[ShenQingchuan]

我核实了一下 mixin 和 effect 算是和之前 wiki 里整理的内容是吻合的

• mixin 不翻译 #350、#382
• hydration 印象中也许很早的时候 v2 或 ssr 的文档里出现过水合的译法，但早已经没有在用了，最近的讨论结果是“激活”，印象中小右当时也线下参与了的讨论 #786
• effect 在特指“effect scope”的时候保留英文，即“effect 作用域”，其它一般化自然语言描述的情况下译为“作用”，例如“side effect”译为副作用 #657

同意对自然存在的 effect 进行翻译。根据上下文语境情况，翻译为 “作用”、“效果” 或者 “影响” 应该都是合理的。

[Jinjiang]

关于 effect 原来的 wiki 里有一个地方要改：effect flush timing 要从副作用刷新时机改为 effect 刷新时机（不过其实这一条感觉不需要在 wiki 里单列出来了）。

认同，我删掉了

[Justineo]

我觉得 effect 作为 Vue 中特定的概念就统一不翻译了，不仅仅针对“effect scope”。Side effect 里面的 effect 不是这个概念，就翻译成“副作用”。

[ShenQingchuan]

我觉得 effect 作为 Vue 中特定的概念就统一不翻译了，不仅仅针对“effect scope”。Side effect 里面的 effect 不是这个概念，就翻译成“副作用”。

cc @Jinjiang @wxsms @Justineo

所以我们针对 effect 有一个结论么？

我个人是觉得 effect 作为一个基本单词，出现的频率很高，我个人在翻译的时候秉持的原则是 “除非一个词确实是很难翻译，且概念非常特殊” 我才会保留原词，尽量不让中文文档中老是出现英文词汇。

另外，这个词结合上下文语境 采用恰当的中文词汇 翻译，往往能更符合中文语言习惯。 cc @yyx990803 可否看完后也给些意见？（ 😅 这次翻译量比较大，大家需要很多时间才可以完整看完）

[Jinjiang]

如果简化一下说法，我们是不是可以认为特指 Vue 里的 Effect Scope API 的时候不翻译，其它场景都翻译成“作用”

Ref：https://v3.vuejs.org/api/effect-scope.html

不仅仅针对“effect scope”

截至目前还有别的特定概念吗？ @Justineo

[Justineo]

有的，Vue 本身就有 watchEffect API，还有之前遇到过的“effect flush timing”。

[Jinjiang]

有的，Vue 本身就有 watchEffect API，还有之前遇到过的“effect flush timing”。

哦，发现了。Effect Scope API 确实范围说得有点太小了。

你觉得可以重新归纳为 Reactivity API 范围内吗？还是索性理解为“Vue 中的相关特定概念”

[Justineo]

就是VCA里的概念吧

[ShenQingchuan]

这里我想先确认一点保证我的理解和大家没有偏差 ...

effect 作为 Composition API 的特定概念是不是就是在表示 "（依赖变更、引发响应式变化所带来的）（副）作用" 呢？还是其他的什么概念 ...

（因为我自己在翻译的时候是这么认为的，如果有误，可能在相应章节有较大调整。）

我感觉在原文中很多地方 effect 和 side effect 表达的意思区别不大呀😂；这二者的具体区别是什么？如果有必要说明的区别可能也需要在翻译中体现。

为了使讨论有效果，我也认同 effect 是特定概念，可以不翻译。

但每当有这种情况，对入门读者来说，很难让他们直接像 redis 一样将一个英语单词对应一个概念。所以我是希望我们能先在文档中说明这个特定概念究竟是什么。

[ShenQingchuan]

这里我想先确认一点保证我的理解和大家没有偏差 ...

effect 作为 Composition API 的特定概念是不是就是在表示 "（依赖变更、引发响应式变化所带来的）（副）作用" 呢？还是其他的什么概念 ...

（因为我自己在翻译的时候是这么认为的，如果有误，可能在相应章节有较大调整。）

我感觉在原文中很多地方 effect 和 side effect 表达的意思区别不大呀😂；这二者的具体区别是什么？如果有必要说明的区别可能也需要在翻译中体现。

为了使讨论有效果，我也认同 effect 是特定概念，可以不翻译。

但每当有这种情况，对入门读者来说，很难让他们直接像 redis 一样将一个英语单词对应一个概念。所以我是希望我们能先在文档中说明这个特定概念究竟是什么。

在 深入响应性原理 原文，定义 “a few terms” 的时候有这样一句：

The update() function produces a side effect, or effect for short, because it modifies the state of the program.

所以我在那之后大多数情况下都把 effect 认为是 side effect 的 short hand

如果是将 原文这一段 “定义了一些术语” 作为概念的介绍，那么引入 effect 这个英语单词是合理的。但我又考虑到这一章节是进阶阅读，且位置偏靠后，所以一般都是用了 “副作用” 这一译法

[Jinjiang]

就是VCA里的概念吧

理论上 VOA 里想用这些 API 也可以，我个人是把 Reactivity API 和 VOA/VCA 分开看的

[Jinjiang]

这里我想先确认一点保证我的理解和大家没有偏差 ...
effect 作为 Composition API 的特定概念是不是就是在表示 "（依赖变更、引发响应式变化所带来的）（副）作用" 呢？还是其他的什么概念 ...
（因为我自己在翻译的时候是这么认为的，如果有误，可能在相应章节有较大调整。）
我感觉在原文中很多地方 effect 和 side effect 表达的意思区别不大呀😂；这二者的具体区别是什么？如果有必要说明的区别可能也需要在翻译中体现。
为了使讨论有效果，我也认同 effect 是特定概念，可以不翻译。
但每当有这种情况，对入门读者来说，很难让他们直接像 redis 一样将一个英语单词对应一个概念。所以我是希望我们能先在文档中说明这个特定概念究竟是什么。

在 深入响应性原理 原文，定义 “a few terms” 的时候有这样一句：

The update() function produces a side effect, or effect for short, because it modifies the state of the program.

所以我在那之后大多数情况下都把 effect 认为是 side effect 的 short hand

如果是将 原文这一段 “定义了一些术语” 作为概念的介绍，那么引入 effect 这个英语单词是合理的。但我又考虑到这一章节是进阶阅读，且位置偏靠后，所以一般都是用了 “副作用” 这一译法

好问题，我个人理解 effect 这个词是从函数式编程里的概念来的。另外 side effect 有一个比较主流的中文翻译了叫“副作用”，相比于“main effect” (似乎没有特别的中文译法与之对应)，指各种除了返回值以外执行函数对外界产生的影响。其余部分我也是一知半解。

回到 Vue 的 effect 相关概念和 API，我个人感觉这里从 tech design 的角度，大家并不介意这个 effect 是 main effect 还是 side effect，总之是个抽象的 effect。比如 watchEffect、effectScope，所以尽管绝大多数情况下有 side effect 产生，我们还是说这是个 effect，没有更具体的指定。

我可以再试着找一些周围对 FP 比较熟的同学加入讨论。

谢谢