Microsoft Wordで行の高さがテキストレイヤーの高さを超える
テキストレイヤーの行の高さが大きい（テキストレイヤー自体の高さを超えている）場合、Microsoft Word（.docx）へのエクスポートでテキストが下にずれます。
Google Sheetsで「ID」列が数値に変換される
CSVファイルをGoogle Sheetsにインポートするときは、必ずConvert text to numbers, dates and formulasのチェックボックスをオフにしてください。オンのままだとFigmaのIDが変更されて崩れてしまい、Figmaに正しく再インポートできなくなります。
フォントが見つからないFigmaレイヤーは、置換・更新・スペルチェックができない
Figmaのテキストレイヤーに見つからないフォントが含まれている場合、プラグインはそのレイヤーを更新できません。CopyDocプラグインで何らかの更新を行いたいテキストレイヤーは、見つからないフォントの問題を解決しておいてください。
Figmaのコメントをエクスポートしようとするとエラーになる
コメントのあるFigmaファイルで有効なFigma APIトークンを使っているのに、トークンが無効だというエラーメッセージが表示される場合は、インターネットサービスプロバイダー（ISP）がFigmaのコメントを取得するAPIリクエストをブロックしている可能性が高いです。おそらくVPNを使って解決する必要があります。
DOCXファイルのエクスポートはGoogleドキュメント向けに最適化されていない
Figmaのデザインを.docxにエクスポートした場合は、Microsoft Wordで開いてください。Googleドキュメントでは一部の機能がサポートされていません。
Google SheetsのURLが読み込まれない
CopyDocにスプレッドシートを接続するときは、GoogleドライブにアップロードしたExcel（.xlsx）ファイルではなく、ネイティブのGoogle Sheetsドキュメントを使う必要があります。
違いは次のとおりです。
- ネイティブのGoogle Sheets：Google Sheetsで直接作成したもの
- GoogleドライブのXLSX：Googleドライブにアップロード、またはGoogleドライブで作成したExcelファイル
Googleの画面上ではほとんど同じに見えますが、CopyDocの連携で使えるのはネイティブのGoogle Sheetsだけです。
Googleドライブ上のXLSXファイルをCopyDocで使いたい場合は、次の手順に従います。
- GoogleドライブでXLSXファイルを開きます
- File → Save as Google Sheetをクリックします
- 新しいGoogle SheetsドキュメントでShareをクリックします
- 権限をAnyone with the link can viewに設定します
- 新しいURLをコピーして、CopyDocに貼り付けます
ヒント：XLSXファイルは、Googleドライブの画面に表示される小さな「XLSX」バッジで見分けられます。
FigmaからPDFをエクスポートすると一部の要素が消えて紫色の四角形になる
これはFigmaの既知の不具合で、画像の代わりに紫色の四角形が表示されることがあります。CopyDocはFigma標準のPDFエクスポートを使っているため、CopyDocでのエクスポートでも同じ問題が起こることがあります。
対処法のひとつとして、問題のあるレイヤーが実際にメインのFigmaフレームの内側に入っているかを確認してください。キャンバス上ではレイヤーが「見た目上」フレームの上に配置されていても、レイヤー自体はフレームの外にあることがあり、これが問題の原因になっている場合があるようです。
PDFのエクスポートが遅い
PDFのエクスポートが非常に遅い場合は、コンテンツの一部に高解像度・大サイズの画像塗りがあり、FigmaのPDF生成に時間がかかっている可能性が高いです。この問題には、TinyImageの「Downsizer」機能を使って画像塗りをレイヤーのサイズに合わせて縮小すると効果があります。ファイルサイズが小さくなり、Figmaファイル内での読み込みもずっと速くなります。Figmaページの画像塗りを縮小し終えたら、CopyDocを再実行してプラグインからもう一度PDFをエクスポートすると、ずっと速くなるはずです。
Adobe AcrobatでPDFを編集すると点線が表示される
PDFの編集中に、Acrobatアプリのサイドバーにある「Show bounding boxes」のトグルをオフにすると解決できます。アプリでPDFを開いて「Edit」モードに入ったときに境界ボックスの点線が表示されるのは、Adobeのデフォルト設定によるものですが、「Show bounding boxes」のトグルをオフにすれば、ワンクリックで非表示にできます。
Unicode文字を含むCSVファイルをMicrosoft Excelで開く
テキストにUnicode文字が含まれている場合（たとえば、ポーランド語やロシア語のコンテンツや、特定のアクセント付き文字を含む場合）、Microsoft Excelでは組み込みのImport Wizardを使ってCSVをインポートする必要があります。Apple KeynoteやGoogle Sheetsなど、ほかのスプレッドシートソフトではこの操作は不要で、CSVファイルを通常どおり開けます。Microsoft Excelでこれを行うには、新しいExcelファイルを作成し、ExcelのヘッダーにあるDataタブをクリックして、From Textボタンを選択します。CopyDocでエクスポートした.csvを選び、file originとしてUTF-8を選択してから、確定してファイルをExcelにインポートします。編集したファイルを保存するときは、CSV UTF-8 (Comma-delimited) (*.csv) オプションを選ぶと、Unicode文字が保持されます（通常のCSVファイルでは疑問符に置き換えられてしまいます）。
WindowsのFigmaデスクトップアプリでファイルの拡張子が空になる
Figmaデスクトップアプリ（Windowsのみ）には既知の問題があり、Figmaからの通常のファイルエクスポートでも同じことが起こります。ファイルを保存するときに「all files」というラベルが表示されることがあります。これを無視して「Save」をクリックして進めれば、正しい拡張子でファイルが保存され、コンピューターにダウンロードされたあと通常どおり開けるはずです。それでも拡張子が空のまま保存される場合は、ファイル名を変更して正しい拡張子を手動で追加してください。
エクスポートした画像が粗くなる
Figmaの画像アセットが段階的に読み込まれている途中でデザインの参照画像をエクスポートしたり、PDF・DOCXをエクスポートしたりすると、画像がFigmaファイル内で完全に読み込まれる前にエクスポートされるため、ピクセル化した見た目になることがあります。これを解決するには、すべての画像が100%読み込まれ、Figmaファイル内で鮮明に表示されていることを確認してから、CopyDocプラグインで再度エクスポートしてください。さらに、「Downsizer」機能を使って画像塗りをレイヤーのサイズに合わせて縮小すると、ファイルサイズが小さくなり、Figmaファイル内での読み込みもずっと速くなります。
中国ではVPNが必要な場合がある
中国にお住まいの場合、アカウントサーバーが「グレート・ファイアウォール」によってブロックされている可能性があります。有効なキーを使っているのに有効化エラーが表示される場合は、おそらくVPNを使って解決する必要があります。
「An error occurred while loading the plugin environment」と表示される
これは、FigmaデスクトップアプリでUse Developer VMというデバッグ設定が誤って有効になっている場合に起こることがあります。オフになっているかを確認するには、Figmaキャンバス上の任意の場所を右クリックし、Plugins、Developmentの順にマウスカーソルを合わせて、Use Developer VMのチェックが外れていることを確認します。チェックが外れたら（横にチェックマークが付いていない状態になったら）、Figmaプラグインを再実行すると正常に動作するはずです。
CopyDocのその他のヘルプ
- CopyDocの「まずはここから」ガイドに従って、プラグインが正しくインストール・設定されているかを確認します。
- CopyDocのテキストエクスポートのワークフローで、更新と再インポートに対応している形式を確認します。
- FigmaからMicrosoft Wordへのチュートリアルで、ドキュメントのエクスポートの全体的な例を確認できます。