第一次翻译，有译不准的地方请多指正。
原文https://www.charlesproxy.com/documentation/tools/rewrite/
Rewrite Tool
The Rewrite tool enables you to create rules that modify requests and
responses as they pass through Charles. Rules such as adding or
changing a header or search and replace some text in the response
body.
你可以用Charles Rewrite功能来重写通过Charles的请求和响应规则：比如添加或修改header、查找并且替换响应中的一些内容。
Rewrite Sets
Rewrite sets can be individually activated and deactivated. Each set
contains a list of locations and rules. The locations choose the requests
and responses on which the rules will operate.
Rewrite设置可以单个的使用或停用。每个设置包含一系列的locations和rules，为指定的locations添加Rewrite规则。
Rewrite Rules
Each rule describes a single rewrite operation. The rule may affect the
headers, the body, or parts of the request URL; it may operate on the
request and or the response; it may then define search and replace or
just replace style rewriting.
每个规则对应一个单一的Rewrite操作。这个规则可以修改headers、body或部分请求的URL，可以用作于请求也可以是响应，可以添加限制条件来修改部分请求或响应也可以直接修改所有的。
Type
The type specifies the type of rewriting operation to perform. There are
four different categories of rewrite rule types; header rules, URL rules,
query parameter rules, and body rules. The header and query
parameter rules affect the header fields and query string parameters
respectively; adding, modifying or removing headers and parameters.
The URL and body rules perform find and replace on the different parts
of the URL and on the body.
需要指定执行Rewrite操作的类型。有四种不同的Rewrite类别，分别是header规则、URL规则、query parameter规则和body规则。header和query parameter规则分别影响header字段和query参数，可以添加、修改或者删除header和parameter。URL和body rules规则在URL的不同部分和body上执行查找和替换。
Where
Choose where to apply the rewrite rule; on the request, response or both.
选择运用重写规则的位置：在请求、响应或两者上。
Match
The match fields contain the text to match in the request or response to
decide whether to fire this rule. You can optionally leave the name or
value blank, or both, to match any value. If you leave both the name
and value fields blank you will match all requests / responses.
Match部分包含在请求或响应中匹配的文本，以决定是否运用该规则。你可以选择不填name或value，您可以选择将名称或值留空，或两者都保留，以匹配任何值。如果name和value字段都为空，则匹配所有请求/响应。
Regex support may be enabled, providing Perl-style regular
expressions for your match. If you include groups in your regular
expression they may be used in the match fields.
可以启用Regex支持，为匹配提供perl样式的正则表达式。如果在正则表达式中包含组，则它们可能在match字段中使用。
The name field is an exact match field unless regex is enabled, in
which case it supports partial matches. The name field is case-
insensitive for both regex and normal matching. The name field may be
disabled if you are creating a rewrite rule type that doesn't require it.
如果不启用regex, name字段就是一个完全匹配字段，在这种情况下，它支持部分匹配。name字段对正则表达式和普通匹配都不区分大小写。如果正在创建不需要重写规则类型，则名称字段可能被禁用。
The value field is a partial match unless you turn on Match whole value
in which case it is an exact match. The value field is case-insensitive
for both regex and normal matching for header and query parameter
rules, and case-sensitive for URL and body rules.
除非你勾选了Match whole value，否则value字段是部分匹配。在这种情况下，它是一个精确的匹配。对于value字段，在header和query parameter规则中，正则表达式和常规匹配不区分大小写，而在URL和body规则中区分。
New/Replace
The new/replace fields contain the text to add or replace in the request
or response when this rule is fired. Leave either the name or value
blank to leave them the same as the matched name or value.
New/Replace字段包含在触发此规则时要在请求或响应中添加或替换的文本。将名称或值留空，使它们与匹配的名称或值保持相同。
If regex support is enabled for the match you may reference match
groups using $1, $2 and so on.
如果为匹配启用了regex支持，则可以使用$1、$2等引用匹配组。
The behaviour of the name and value fields depends upon the match. If
there is a corresponding match then the field acts as a replacement for
the matched text, otherwise if the match is blank then the fields
replaces the whole name or value.
name和value字段的行为取决于匹配。如果有一个相应的匹配，然后该字段作为替代匹配的文本，否则如果匹配为空，则为字段替换整个名称或值。
The value field supports Replace First or Replace All modes. The
name field always operates in replace-first mode if the name match is a
regex, otherwise it is an exact match and replaces the whole name.
value字段支持替换第一个或替换所有模式。如果name匹配是正则表达式，则name字段始终替换第一个，否则它就是精确匹配并替换整个name。
The name and or value fields may be disabled if you are creating a
rewrite rule type that doesn't require them.
可以将name和value字段禁掉，如果在创建一个不需要他们的rewrite规则类型时。
Recommendations
Rewrite rules can be difficult to debug if they are not working as you
expect. It is often best to build up a rule slowly with frequent testing.
rewrite规则很难进行调试，如果他们没有按你期望的运行。通常最好通过频繁测试来慢慢建立规则。
Location Matching
Each location match may contain protocol, host, port and path patterns
to match specific URLs. Locations may include wildcards. More help for
creating location matches may be found when you add a new location
to this tool.
每个地址匹配可以包含协议、主机、端口和路径模式，去匹配特定的URL。地址可以包括通配符。当你为该工具添加新地址时，可能会发现更多关于创建位置匹配的帮助。
Debugging
The Rewrite tool can be difficult to debug when your rewrite operation
isn't working as expected. If you have trouble try including a very basic
rule such as one that adds an obvious header, so you can see whether
your rules are matching the request at all. Also turn on Debug in Error
Log to get some debugging information printed in the Error Log
accessed from the Window menu in Charles.
Rewrite tool很难调试，当你的重写操作没有按预期工作时。如果您遇到困难，可以尝试一个非常基本的规则，比如添加一个明显的头部规则，这样你就可以看到你的规则是否与请求完全匹配。还可以在错误日志中打开Debug，以从Charles中的窗口菜单中获取在错误日志中打印的调试信息。
网友评论