1. 使用教程 — Pyarmor 8.6.0 文档

PyArmor 是一个用于加密和混淆 Python 脚本的工具。

以下是 PyArmor 的基本用法：

**一、安装** 可以使用 `pip` 命令进行安装：

         ``` pip install pyarmor ```

**二、加密单个脚本**

1. 假设你有一个名为 `my_script.py` 的 Python 脚本。要加密这个脚本，可以在命令行中执行以下命令：

        ``` pyarmor obfuscate my_script.py ```

这将生成一个加密后的脚本，默认情况下保存在一个名为 `dist/` 的目录中。

2. 运行加密后的脚本：加密后的脚本可以像普通脚本一样运行。例如，如果加密后的脚本名为 `my_script.py`（在 `dist/` 目录下），可以使用以下命令运行它：

        ``` python dist/my_script.py ```

**三、加密整个项目**

1. 如果你有一个包含多个脚本和模块的项目，可以使用以下命令加密整个项目：

        ``` pyarmor obfuscate my_project/ ```

        其中 `my_project/` 是项目的目录。

2. 运行加密后的项目：运行加密后的项目可能需要一些额外的配置，具体取决于项目的结构和依赖关系。通常，你可以在项目的入口点脚本中添加适当的路径设置，以便能够正确导入加密后的模块。

**四、高级用法**

1. 配置加密选项：PyArmor 提供了许多配置选项，可以通过创建一个配置文件来定制加密过程。例如，可以设置加密强度、排除某些文件或目录、指定输出目录等。配置文件是一个 Python 脚本，可以使用以下命令生成一个默认配置文件：

        ``` pyarmor init ```

        生成的配置文件名为 `pyarmor.cfg`，你可以根据需要修改这个文件。

2. 结合其他工具：PyArmor 可以与其他工具结合使用，例如打包工具（如 `pyinstaller`），以便将加密后的脚本打包成可执行文件。

**五、注意事项**

1. 加密后的脚本可能会有一些性能开销，具体取决于加密强度和脚本的复杂性。

2. 在加密之前，最好备份原始脚本，以防万一需要恢复原始版本。

3. 确保在加密后的环境中测试你的脚本，以确保其正常运行。

4. PyArmor 的加密并不是绝对安全的，它主要是为了增加逆向工程的难度，而不是完全防止破解。 总之，PyArmor 是一个强大的工具，可以帮助你保护 Python 代码的知识产权。通过合理配置和使用，你可以有效地加密和混淆你的 Python 脚本和项目。

`pyarmor obfuscate`和`pyarmor gen`在 PyArmor 中有以下区别：

**一、pyarmor obfuscate**

1. **功能**：主要用于对 Python 脚本进行混淆加密。它通过对代码进行一系列的变换和处理，使得代码更难以被逆向分析和理解。

2. **使用场景**： - 当你希望保护自己的 Python 代码不被轻易窃取或破解时，可以使用这个命令对单个脚本或整个项目进行混淆处理。 - 适用于对代码安全性要求较高的场景，比如商业软件、知识产权保护等。

**二、pyarmor gen**

1. **功能**：这个命令更加灵活，可以根据不同的参数生成不同类型的加密结果。例如，可以生成带有特定配置的加密脚本，或者生成用于部署的加密包等。

2. **使用场景**： - 如果你需要对加密过程进行更多的定制化操作，可以使用`pyarmor gen`。比如，你可以指定特定的输出目录、加密强度、是否包含运行时库等。 - 当你需要将加密后的代码部署到不同的环境中时，`pyarmor gen`可以帮助你生成适合特定环境的加密结果。 总体而言，`pyarmor obfuscate`是一种相对简单直接的混淆加密方式，而`pyarmor gen`提供了更多的灵活性和定制化选项，可以满足不同的加密需求。